// 免費工具

MariaDB 連線字串產生器

從同一個表單建立 MariaDB JDBC URL、ADO.NET 字串或 Go DSN,或貼上現有字串,看看每個選項的作用,以及 TLS 是否真的有啟用。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。

在 SQLly 中開啟此連線

開啟 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。