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 版本在以下情况会以不带 TLS 的方式连接: sslMode 未设置时不带 TLS 连接,而 4.0 把默认值改成了 verify-full,遇到使用自签名证书的服务器就会失败。
JDBC MariaDB 连接器/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 连接器/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 的信息: SQLly 适用于 MariaDB.
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 | 主机、逗号分隔的列表或 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 注入的影响范围。 |
常见的 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,或者使用与你所连主机名相匹配的证书。 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。