// 免費工具

MySQL 連線字串產生器

從同一個表單建立 MySQL 連線 URI、JDBC URL、ADO.NET 字串、ODBC 字串或 Go DSN,或貼上現有字串,看看每個選項的作用,並揪出像 allowPublicKeyRetrieval 這類不安全的設定。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。

在 SQLly 中開啟此連線

開啟 SQLly 的連線編輯器,並自動填入內容。

設計即私密。 建構器和解碼器都是在此分頁中執行的純 JavaScript。頁面不會發送你輸入的任何請求,也不會儲存任何資料(甚至不在你的瀏覽器中),載入後可離線使用。開啟 SQLly 的連結會從你的瀏覽器直接進入你電腦上的應用程式。

MySQL 連線字串格式

MySQL 沒有單一的連線字串標準。Connector/J 使用含駝峰式大小寫屬性的 JDBC URL(sslMode, connectTimeout 以毫秒為單位),MySqlConnector 和 Connector/NET 使用 ADO.NET Server=...; 字串,Connector/ODBC 使用 ODBC 關鍵字,Go 的驅動程式有自己的 user:pass@tcp(host:3306)/db DSN,而 MySQL Shell 則接受含有 ssl-mode.

TLS 預設為 PREFERRED 幾乎所有情況:伺服器支援時會加密,但不檢查憑證。 VERIFY_IDENTITY (MySqlConnector: VerifyFull)會檢查 CA 和主機名稱。

URI MySQL Shell、mysql2、Prisma

mysql://app_user:[email protected]/sales?ssl-mode=VERIFY_IDENTITY

JDBC MySQL Connector/J

jdbc:mysql://db.example.com/sales?user=app_user&password=your_password&sslMode=VERIFY_IDENTITY

ADO.NET MySqlConnector、MySql.Data

Server=db.example.com;Database=sales;User ID=app_user;Password=your_password;SslMode=VerifyFull;

ODBC MySQL Connector/ODBC

Driver={MySQL ODBC 8.0 Unicode Driver};Server=db.example.com;Database=sales;Uid=app_user;Pwd=your_password;SslMode=VERIFY_IDENTITY;

Go DSN github.com/go-sql-driver/mysql

app_user:your_password@tcp(db.example.com)/sales?tls=true

SQLAlchemy URL Python SQLAlchemy 搭配 PyMySQL

mysql+pymysql://app_user:[email protected]/sales?charset=utf8mb4

預留位置,例如 your_password 就只是這個意思:用上面的表單組出你自己的字串。更多關於把 SQLly 連上 MySQL 的說明: 適用於 MySQL 的 SQLly.

MySQL Connector/J 屬性

URL 格式: jdbc:mysql://[host][:port][/database][?property=value&...]。百分比編碼保留字元(/ : @ ( ) [ ] & # = ? 和空格)到處都要,包括使用者名稱與密碼。

關鍵字同義詞預設其作用
user / password - - 憑證。
sslMode - 優選 DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY.
useSSL / requireSSL / verifyServerCertificate - - 已淘汰;仍會轉換(useSSL=false = DISABLED). sslMode 會勝出。
connectTimeout - 0(無) 等待通訊端連線的毫秒數。
socketTimeout - 0(無) 讀取可封鎖的毫秒數。
allowPublicKeyRetrieval - 假 讓客戶端要求伺服器的 RSA 金鑰以 caching_sha2_password 沒有 TLS。
connectionTimeZone 伺服器時區 本機 LOCAL, SERVER 或區域 ID。
characterEncoding - utf8mb4 (8.0.26+) Java 字元集。
trustCertificateKeyStoreUrl - - 信任存放區內含伺服器的 CA,適用於 VERIFY_CA / VERIFY_IDENTITY。
rewriteBatchedStatements - 假 將整批送出的 INSERT 改寫成多列陳述式。

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 注入的影響。

MySQL Connector/ODBC 關鍵字

關鍵字不區分大小寫。驅動程式名稱必須與 ODBC 管理員中註冊的名稱一致,版本資訊也包含在名稱中。

關鍵字同義詞預設其作用
Driver - - 例如 {MySQL ODBC 8.0 Unicode Driver}.
Server - localhost 主機。
Port - 3306 TCP 連接埠。
Database - - 預設結構描述。
User 使用者識別(UID) - 使用者名稱。
Password PWD - 密碼。
SSLMODE ssl 模式 (8.0.29+) 優選 DISABLED, PREFERRED, REQUIRED, VERIFY_CA, VERIFY_IDENTITY.

常見的 MySQL 連線錯誤

Access denied for user 'app_user'@'10.0.0.7' (using password: YES)

原因: 錯誤 1045:密碼錯誤,或該帳戶存在於另一個主機模式('app_user'@'localhost' 有別於 'app_user'@'%').

修正此問題: 檢查密碼並 SELECT user, host FROM mysql.user;請為你連線來源的主機建立或授權帳戶。

Public Key Retrieval is not allowed

原因: Connector/J 搭配 MySQL 8 的 caching_sha2_password 在未使用 TLS 的連線上:驅動程式需要伺服器的 RSA 金鑰才能傳送密碼,卻不被允許主動要求該金鑰。

修正此問題: 使用 TLS(sslMode=REQUIRED 或更強)。 allowPublicKeyRetrieval=true 也可行,但在不受信任的網路上,容易受到中間人攻擊。

Can't connect to MySQL server on 'db.example.com:3306' (110)

原因: 錯誤 2003:無法連線到伺服器:主機或連接埠錯誤, bind-address 限制於 127.0.0.1,或防火牆阻擋。(111 表示連線被拒,110 表示連線逾時。)

修正此問題: 檢查 bind-address 和 port 在 my.cnf、防火牆和雲端安全群組中,然後用 nc -vz db.example.com 3306.

Host '10.0.0.7' is not allowed to connect to this MySQL server

原因: 錯誤 1130:沒有帳戶同時符合使用者名稱與你的用戶端主機。

修正此問題: 為你的主機或一個模式建立帳戶: CREATE USER 'app_user'@'10.0.0.%' ... 並授予它所需的權限。

Unknown database 'sales'

原因: 錯誤 1049:字串中的結構描述不存在,或其名稱在資料表名稱區分大小寫的伺服器上大小寫不符。

修正此問題: 檢查 SHOW DATABASES; 以及確切的拼法。

Authentication plugin 'caching_sha2_password' cannot be loaded

原因: 早於 MySQL 8 預設驗證外掛的舊版用戶端程式庫。

修正此問題: 請升級用戶端或連接器。將帳戶變更為 mysql_native_password 是一個權宜之計;該外掛已被棄用。

MySQL 連線字串常見問題

MySQL 連線字串的格式是什麼?

這取決於驅動程式。JDBC: jdbc:mysql://host:3306/db?user=...&password=...。ADO.NET: Server=host;Port=3306;Database=db;User ID=user;Password=...;。Go: user:password@tcp(host:3306)/db。MySQL Shell 和許多 Node 及 ORM 工具都接受 mysql://user:password@host:3306/db.

MySQL 的預設連接埠是多少?

3306 用於傳統協定,33060 用於 X 協定(mysqlx://).

我應該使用 useSSL=false 嗎?

不。 useSSL 在 Connector/J 中已被棄用;請使用 sslMode. sslMode=DISABLED (什麼 useSSL=false 對應到)會以純文字傳送查詢和結果。使用 VERIFY_IDENTITY 在可以的情況下,使用伺服器的 CA,或者至少 REQUIRED.

allowPublicKeyRetrieval=true 是否安全?

僅在 TLS 或受信任的網路環境下安全。MySQL 8 的預設 caching_sha2_password 需要 TLS 或伺服器的 RSA 公開金鑰才能傳送密碼。若讓用戶端在未經驗證的情況下取得該金鑰,中間人攻擊者就能提供自己的金鑰並讀取密碼。建議使用 TLS (sslMode=REQUIRED 或更強)。

在 Go MySQL DSN 中,密碼是否需要跳脫處理?

不。go-sql-driver/mysql 的文件寫明,密碼可以包含任何字元而無需跳脫;驅動程式會在最後一個 @。查詢參數值必須做 URL 跳脫編碼,參數名稱分大小寫(parseTime,而不是 parsetime).

為什麼在 JDBC 中 connectTimeout 這麼大?

Connector/J 的 connectTimeout 和 socketTimeout 是以毫秒為單位,兩者的預設值都是 0,表示無限制。 connectTimeout=10000 是十秒。MySqlConnector 的 Connection Timeout 是以秒為單位(預設 15)。

// 完全跳過字串

連線一次。然後只需撰寫 SQL。

SQLly 是適用於 macOS、Windows 和 Linux 的原生 SQL 工作台。把連線字串貼進連線編輯器,密碼存在系統鑰匙圈裡,就能在 MySQL 及更多引擎上獲得結構描述感知的 IntelliSense。