连接字符串生成器与解码器
填写表单,即可并排获得驱动程序所用的各种格式的连接字符串 - ADO.NET、JDBC、ODBC、URLs、libpq、Go DSNs 等。或者粘贴一个连接字符串,查看每个键的作用以及哪里有风险。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。
在 SQLly 中打开此连接
从设计上保护隐私。 构建器和解码器是运行在此标签页中的纯 JavaScript。页面不会把你输入的内容发送给任何服务器,不存储任何内容(甚至不存入浏览器),一旦加载完毕即可离线继续工作。“在 SQLly 中打开”链接会直接从浏览器跳转到你电脑上的应用。
选择你的数据库
每个引擎页面都会在该引擎上打开构建器,并附加完整的关键字参考、常见连接错误及其解决方法。
SQL Server
ADO.NET、ODBC、JDBC、Go URL、SQLAlchemy URL
PostgreSQL
URI、关键字/值、ADO.NET (Npgsql)、JDBC、ODBC
MySQL
URI、JDBC、ADO.NET、ODBC、Go DSN
MariaDB
JDBC、ADO.NET、Go DSN、SQLAlchemy URL、URI
SQLite
文件路径,URI 文件名(只读),ADO.NET,JDBC,SQLAlchemy URL
Oracle
Easy Connect、Easy Connect over TLS、连接描述符、JDBC thin、ADO.NET (ODP.NET)
Redis
带 TLS 的 URI、带 ACL 用户的 URI(Redis 6+)、StackExchange.Redis、redis-cli
ClickHouse
HTTP URL,原生 DSN,JDBC,ADO.NET
DuckDB
文件路径,JDBC,SQLAlchemy URL,CLI,只读
libSQL
数据库 URL,带身份验证令牌的 URL,本地 sqld
连接字符串格式,以及如何转义它们
最多要素数 @、 ; 或引号,驱动会把它在错误的位置切开。每种格式都有自己的规则。
| 格式 | 看起来像 | 特殊字符 |
|---|---|---|
| URL / URI | postgresql://user:pass@host:5432/db?sslmode=verify-full | 对用户、密码和数据库中的保留字符进行百分号编码: @ → %40, : → %3A, / → %2F, ? → %3F, # → %23, % → %25空格 → %20. |
| ADO.NET | Server=host;Database=db;User ID=u;Password=p; | 用 ;、前导或尾随空格,或者开头的引号,在 "…" (或者 '…'),并将内部的引号字符写成两个: Password="a;b""c". |
| ODBC | Driver={ODBC Driver 18 for SQL Server};Server=host;Pwd={p;w}; | 用大括号把值括起来。驱动程序名称总是这样。 |
| JDBC | jdbc:sqlserver://host;databaseName=db, jdbc:postgresql://host/db?user=u | 因厂商而异。微软:用大括号,配合 } 翻倍。PostgreSQL、MySQL、MariaDB:放在 URL 查询串里,所以要百分号编码。 |
| libpq 关键字/值 | host=h dbname=db user=u password='a b' | 为空或包含空格的值请用单引号括起;写作 \' 和 \\ ,用来转义引号或反斜杠。 |
| Go MySQL DSN | user:pass@tcp(host:3306)/db?tls=true | 密码无需转义;参数值需进行 URL 转义;参数名区分大小写。 |
| StackExchange.Redis | host:6380,password=p,ssl=true | 逗号分隔选项,因此包含逗号的密码必须在代码中设置。 |
| Oracle 简易连接 | host:1521/service_name | 其中不含凭据;请单独提供用户名和密码。 |
解码器检查的内容
- 证书检查已关闭。
TrustServerCertificate=true,sslmode=require,tls=skip-verify,sslMode=trust以及 pgJDBC 的NonValidatingFactory都会加密,但不校验响应方的身份。 - 没有 TLS,或者 TLS 可回退。
sslmode=disable或者prefer,Encrypt=False,ssl-mode=DISABLED,redis://使用密码,通过明文 HTTP 连接到 ClickHouse。 - 已更改的默认设置。 否
Encrypt表示在 Microsoft.Data.SqlClient 4.0+、ODBC Driver 18 和 JDBC 10.2+ 中会加密并验证,但在更旧的驱动或 go-mssqldb 中不会。 - 字符串中的机密。 明文密码和认证令牌,
Persist Security Info=True,以及已过期的 Turso 令牌。 - 拼写错误和借用的关键字。 检测到的驱动无法识别的键,
host:port而 SQL Server 要求的却是host,port,区分大小写的 Go 参数,URL 密码里未转义的@在 URL 密码中,应为服务名的 Oracle SID。 - SQLly 如何读取它。 解码器会沿用与 SQLly 应用自身连接字符串读取器相同的规则,因此你能预知应用会填入什么。
连接字符串常见问题解答
我的连接字符串会被发送出去吗?
不会。构建器和解码器是运行在你浏览器标签页里的 JavaScript。你输入或粘贴的内容不会被上传、记录或存储,甚至不会写入浏览器存储;页面加载完成后,即使断网也照常可用。
它支持哪些数据库和驱动?
SQL Server 和 Azure SQL、PostgreSQL、MySQL、MariaDB、SQLite、Oracle、Redis 和 Valkey、ClickHouse、DuckDB,以及 libSQL / Turso。对每种引擎,它只生成该引擎真正存在的格式:URL、ADO.NET、JDBC、ODBC、libpq 关键字/值字符串、Go DSN、SQLAlchemy URL、StackExchange.Redis 字符串、Oracle Easy Connect 和 TNS 描述符,外加可直接粘贴的 Python 和 Node.js 代码。
如何在密码中使用特殊字符?
这取决于格式。在 URL 中,对它们进行百分号编码: @ 变为 %40, : 变为 %3A, / 变为 %2F, % 变为 %25。在 ADO.NET 字符串中,要把含有 ; 或含引号的值用双引号包起来,并把内部每个双引号写成两个。在 ODBC 和微软的 JDBC 驱动中,要用花括号包裹 {...} 并把右花括号写成两个。在 libpq 关键字/值字符串里,用单引号并用反斜杠转义 ' 和 \。构建器会替你完成这一切。
解码器检查什么?
它会像驱动程序那样读取字符串,列出每个键及其作用,并标出问题:证书检查被关闭(TrustServerCertificate=true, sslmode=require, tls=skip-verify)、TLS 被禁用或可选、明文密码和令牌、拼写错误或未知的关键字, host:port 而 SQL Server 要求的却是 host,port、URL 密码中未转义的字符、Oracle 里 SID 和服务名搞混,以及驱动版本之间变过的默认值,例如 Encrypt 在 Microsoft.Data.SqlClient 4.0 中。
驱动程序升级后为什么我的连接会因证书错误而失败?
Microsoft.Data.SqlClient 4.0、ODBC Driver 18 和 Microsoft JDBC Driver 10.2 都改为默认加密并验证服务器证书。仍使用自签名证书的 SQL Server 会因此连接失败,报“证书链是由不受信任的颁发机构颁发的”。请安装客户端信任的 CA 颁发的证书;设置 TrustServerCertificate=true 仅用于本地开发。
“在 SQLly 中打开”是什么意思?
SQLly 是一个适用于 macOS、Windows 和 Linux 的桌面 SQL 客户端。该按钮会生成一个 sqlly://connection/new 链接,点击该链接会打开 SQLly 的连接编辑器,并自动填入您的主机、端口、数据库和用户信息。只有在您勾选框时,密码才会被包含在链接中,SQLly 永远不会将密码写入其连接文件。该链接直接从您的浏览器到您电脑上的应用程序传输;不会通过任何服务器。
连接一次。之后只管写 SQL。
SQLly 是适用于 macOS、Windows 和 Linux 的原生 SQL 工作台。在连接编辑器中粘贴连接字符串,把密码保存在系统钥匙串里,并在 数据库 等引擎上获得模式感知的 IntelliSense。