MariaDB 連線字串產生器
從同一個表單建立 MariaDB JDBC URL、ADO.NET 字串或 Go DSN,或貼上現有字串,看看每個選項的作用,以及 TLS 是否真的有啟用。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。
在 SQLly 中開啟此連線
設計即私密。 建構器和解碼器都是在此分頁中執行的純 JavaScript。頁面不會發送你輸入的任何請求,也不會儲存任何資料(甚至不在你的瀏覽器中),載入後可離線使用。開啟 SQLly 的連結會從你的瀏覽器直接進入你電腦上的應用程式。
MariaDB 連線字串格式
MariaDB 使用 MySQL 協定,因此 MySQL 驅動程式(MySqlConnector、go-sql-driver/mysql、mysql2)能用同一組連線字串連線。MariaDB 自家的 Connector/J 則使用 jdbc:mariadb:// 以及不同 sslMode 用詞,而不是 MySQL 的那幾個: disable, trust, verify-ca, verify-full.
注意 Connector/J 的預設值:3.x 版本在 sslMode 未設定時會在沒有 TLS 的情況下連線,而 4.0 將預設值改為 verify-full,這在使用自簽署憑證的伺服器上會失敗。
JDBC MariaDB Connector/J
jdbc:mariadb://db.example.com/sales?user=app_user&password=your_password&sslMode=verify-full
ADO.NET MySqlConnector
Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;
Go DSN github.com/go-sql-driver/mysql
app_user:your_password@tcp(db.example.com)/sales?tls=true
SQLAlchemy URL MariaDB Connector/Python
mariadb+mariadbconnector://app_user:[email protected]/sales
URI SQLly 和 URI 風格的工具
mariadb://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY
預留位置,例如 your_password 就只是這個意思:用上面的表單組出你自己的字串。更多關於把 SQLly 連上 MariaDB 的說明: 適用於 MariaDB 的 SQLly.
MariaDB Connector/J 選項
URL 格式: jdbc:mariadb:[replication:|loadbalance:|sequential:]//host[:port][,...]/[database][?key=value&...]。Connector/J 3.x 僅接受 jdbc:mysql: 與 permitMysqlScheme.
| 關鍵字 | 同義詞 | 預設 | 其作用 |
|---|---|---|---|
user / password |
- | - | 憑證。 |
sslMode |
- | disable(3.x);verify-full(4.0+) | disable, trust (加密,不檢查), verify-ca, verify-full,而且 allow (3.5.11+). |
serverSslCert |
- | - | verify-ca / verify-full 的 CA 或伺服器憑證(路徑或 PEM)。 |
connectTimeout |
- | 30000 | 等待連線的毫秒數。 |
socketTimeout |
- | 0 | 讀取可封鎖的毫秒數。 |
allowPublicKeyRetrieval |
- | 假 | 在沒有 TLS 的情況下請求伺服器的 RSA 金鑰。 |
MySqlConnector (ADO.NET) 選項
MySqlConnector 與 Oracle 的 Connector/NET (MySql.Data) 大部分關鍵字共用。值若有 ; 則要用雙引號括住。
| 關鍵字 | 同義詞 | 預設 | 其作用 |
|---|---|---|---|
Server |
Host、Data Source、Address | localhost | Host、逗號分隔清單,或 Unix 通訊端路徑。 |
Port |
- | 3306 | TCP 連接埠。 |
User ID |
UID、User、Username | - | 使用者名稱。 |
Password |
PWD | - | 密碼。 |
Database |
初始目錄 | - | 預設結構描述。 |
SslMode |
SSL 模式 | 首選 | None/Disabled, Preferred, Required, VerifyCA, VerifyFull. |
SslCa |
CA 憑證檔案, Ssl-Ca | - | VerifyCA / VerifyFull 使用的 CA 檔案。 |
Connection Timeout |
連線逾時 | 15 | 秒數。 |
Default Command Timeout |
命令逾時 | 30 | 秒;0 表示永遠等待。 |
Application Name |
- | - | 設定 program_name 連線屬性。 |
AllowPublicKeyRetrieval |
- | 假 | 請參見上方警告。 |
AllowUserVariables |
- | 假 | 允許 @variables 在 SQL 中。 |
Pooling |
- | 真 | 連線池機制。 |
Maximum Pool Size |
最大連線池大小 | 100 | 最大的連線池大小。 |
Minimum Pool Size |
最小連線池大小 | 0 | 最小的連線池。 |
go-sql-driver/mysql DSN
表單: [user[:password]@][protocol[(address)]]/dbname[?param=value&...]。密碼不需要跳脫;資料庫名稱做路徑跳脫(1.8+);參數值做查詢跳脫;參數名稱分大小寫。
| 關鍵字 | 同義詞 | 預設 | 其作用 |
|---|---|---|---|
tcp(host:port) |
unix(/path) | tcp(127.0.0.1:3306) | 位址;連接埠預設為 3306。 |
tls |
- | 假 | true (驗證), false, skip-verify (加密,不檢查), preferred,或已註冊的設定名稱。 |
timeout |
- | 作業系統預設 | 連線逾時,須附單位: 10s. |
readTimeout / writeTimeout |
- | 0 | I/O 逾時值需附單位。 |
parseTime |
- | 假 | 將 DATE 和 DATETIME 掃描為 time.Time. |
loc |
- | 協調世界時間 (UTC) | 時區為 time.Time 值(逸出 / 作為 %2F). |
collation |
- | utf8mb4_general_ci | 連線定序。 |
allowCleartextPasswords |
- | 假 | 以明文傳送密碼(僅透過 TLS)。 |
multiStatements |
- | 假 | 每個查詢可含多條陳述式;擴大 SQL 注入的影響。 |
常見的 MariaDB 連線錯誤
Access denied for user 'app_user'@'10.0.0.7' (using password: YES)
原因: 密碼錯誤,或帳戶是定義給別的主機模式。
修正此問題: 檢查 SELECT user, host FROM mysql.user 並為你連線來源的主機建立或授權帳戶。
Could not connect to address=(host=db.example.com)(port=3306)(type=primary) : ... certificate
原因: Connector/J 4.0+ 預設為 sslMode=verify-full,而伺服器提供自簽署憑證或其他名稱的憑證。
修正此問題: 以下列方式把 CA 提供給驅動程式 serverSslCert=/path/ca.pem給驅動程式 CA,或使用你所連線主機名稱的憑證。 sslMode=trust 會加密但不驗證,只適用於受信任的網路。
Host '10.0.0.7' is not allowed to connect to this MariaDB server
原因: 沒有符合你使用者名稱與用戶端主機的帳戶。
修正此問題: 為你的主機或像這樣的模式建立帳戶 'app_user'@'10.0.0.%'.
Unknown database 'sales'
原因: 連線字串中的資料庫不存在,或拼法不同。
修正此問題: 檢查 SHOW DATABASES;.
MariaDB 連線字串常見問題
我可以用 MySQL 驅動程式連線 MariaDB 嗎?
可以,常見情況都可以。MariaDB 沿用 MySQL 的用戶端通訊協定,因此 MySqlConnector、Connector/NET、go-sql-driver/mysql、mysql2 和 PyMySQL 都能用相同的連線字串連上。MariaDB 特有的功能,還是用 MariaDB 自己的連接器支援得最完整。
sslMode=trust 是什麼意思?
這是 MariaDB Connector/J 對應 MySQL 的 REQUIRED:連線有加密,但不檢查伺服器憑證。使用 verify-full 與 serverSslCert 來驗證伺服器。
MariaDB 的預設連接埠是多少?
3306,與 MySQL 相同。
為什麼在升級 Connector/J 後我的 MariaDB JDBC 連線中斷了?
Connector/J 4.0 改變了 sslMode 的預設值從 disable 到 verify-full。沒有 TLS 或使用自簽憑證的伺服器現在會直接失敗。請正確設定 TLS,或設定 sslMode 明確指定。
連線一次。然後只需撰寫 SQL。
SQLly 是適用於 macOS、Windows 和 Linux 的原生 SQL 工作台。把連線字串貼進連線編輯器,密碼存在系統鑰匙圈裡,就能在 MariaDB 及更多引擎上獲得結構描述感知的 IntelliSense。