// 免费工具

连接字符串生成器与解码器

填写表单,即可并排获得驱动程序所用的各种格式的连接字符串 - ADO.NET、JDBC、ODBC、URLs、libpq、Go DSNs 等。或者粘贴一个连接字符串,查看每个键的作用以及哪里有风险。 所有操作都在你的浏览器中运行:你输入的内容不会被发送到任何地方。

在 SQLly 中打开此连接

打开 SQLly 的连接编辑器并自动填入内容。

从设计上保护隐私。 构建器和解码器是运行在此标签页中的纯 JavaScript。页面不会把你输入的内容发送给任何服务器,不存储任何内容(甚至不存入浏览器),一旦加载完毕即可离线继续工作。“在 SQLly 中打开”链接会直接从浏览器跳转到你电脑上的应用。

连接字符串格式,以及如何转义它们

最多要素数 @、 ; 或引号,驱动会把它在错误的位置切开。每种格式都有自己的规则。

格式看起来像特殊字符
URL / URIpostgresql://user:pass@host:5432/db?sslmode=verify-full对用户、密码和数据库中的保留字符进行百分号编码: @ → %40, : → %3A, / → %2F, ? → %3F, # → %23, % → %25空格 → %20.
ADO.NETServer=host;Database=db;User ID=u;Password=p;用 ;、前导或尾随空格,或者开头的引号,在 "…" (或者 '…'),并将内部的引号字符写成两个: Password="a;b""c".
ODBCDriver={ODBC Driver 18 for SQL Server};Server=host;Pwd={p;w};用大括号把值括起来。驱动程序名称总是这样。
JDBCjdbc: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 DSNuser:pass@tcp(host:3306)/db?tls=true密码无需转义;参数值需进行 URL 转义;参数名区分大小写。
StackExchange.Redishost: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。