連線字串產生器與解碼器
填寫表單,即可並排取得你的驅動程式會用到的每一種連線字串格式——ADO.NET、JDBC、ODBC、URL、libpq、Go DSN 等。也可以貼上一條連線字串,看看每個鍵的作用以及哪裡有風險。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。
在 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、透過 TLS 的 Easy Connect、連線描述符、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 | 依供應商而異。Microsoft:大括號,搭配 } 加倍。PostgreSQL、MySQL、MariaDB:URL 查詢,因此要進行百分比編碼。 |
| libpq 關鍵字/值 | host=h dbname=db user=u password='a b' | 將空值或含有空白的值用單引號括起來;寫 \' 和 \\ 用於引號或反斜線。 |
| Go MySQL 資料來源名稱 | 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:portSQL Server 所需的位置host,port、區分大小寫的 Go 參數,以及未跳脫的@在 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 和 Microsoft 的 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 就會出現「The certificate chain was issued by an authority that is not trusted」的錯誤。請安裝用戶端信任的 CA 所核發的憑證;設定 TrustServerCertificate=true 僅供本機開發使用。
什麼是「在 SQLly 中開啟」?
SQLly 是一款適用於 macOS、Windows 和 Linux 的桌面 SQL 用戶端。這個按鈕會建立一個 sqlly://connection/new 連結,會開啟 SQLly 的連線編輯器,並已填好你的主機、連接埠、資料庫與使用者。只有在你勾選核取方塊時,密碼才會放進連結,而且 SQLly 絕不會把它寫進連線檔案。連結會直接從你的瀏覽器傳到電腦上的應用程式,不會經過任何伺服器。
連線一次。然後只需撰寫 SQL。
SQLly 是適用於 macOS、Windows 和 Linux 的原生 SQL 工作台。把連線字串貼進連線編輯器,密碼存在系統鑰匙圈裡,就能在資料庫及更多引擎上獲得結構描述感知的 IntelliSense。