MySQL 連線字串產生器
從同一個表單建立 MySQL 連線 URI、JDBC URL、ADO.NET 字串、ODBC 字串或 Go DSN,或貼上現有字串,看看每個選項的作用,並揪出像 allowPublicKeyRetrieval 這類不安全的設定。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。
在 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; 以及確切的拼法。
Communications link failure
原因: Connector/J 無法完成與伺服器的通訊:網路中斷、TLS 交握失敗、 wait_timeout 關閉閒置的連線池連線,或途中有代理伺服器擋道。
修正此問題: 檢視內層原因。若是 TLS 問題,請檢查 sslMode 以及信任存放區;若要避免閒置斷線,就把連線池的最大存活時間設得低於伺服器的 wait_timeout.
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。