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 接受带有 URI 的 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 使用 PyMySQL 的 Python SQLAlchemy
mysql+pymysql://app_user:[email protected]/sales?charset=utf8mb4
占位符,例如 your_password 就是这样:用上面的表单自己拼一个连接字符串即可。更多关于将 SQLly 连接到 MySQL 的信息: SQLly 适用于 MySQL.
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 |
serverTimezone | 本地 | 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 | 主机、逗号分隔的列表或 Unix 套接字路径。 |
Port |
- | 3306 | TCP 端口。 |
User ID |
UID、用户、用户名 | - | 用户名。 |
Password |
PWD | - | 密码。 |
Database |
Initial Catalog | - | 默认模式。 |
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 |
- | true | 连接池。 |
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 |
- | 世界标准时间 | 时区用于 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-mode (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,X 协议用 33060 (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。