// 免費工具

SQL Server 連線字串產生器

從同一個表單建立 SQL Server 或 Azure SQL 連線字串,適用 ADO.NET (Microsoft.Data.SqlClient)、ODBC Driver 18、JDBC、Go 和 SQLAlchemy,或貼上現有字串,看看每個關鍵字的作用,以及哪些設定有風險。 一切都在你的瀏覽器中執行:你輸入的任何內容都不會外傳。

在 SQLly 中開啟此連線

開啟 SQLly 的連線編輯器,並自動填入內容。

設計即私密。 建構器和解碼器都是在此分頁中執行的純 JavaScript。頁面不會發送你輸入的任何請求,也不會儲存任何資料(甚至不在你的瀏覽器中),載入後可離線使用。開啟 SQLly 的連結會從你的瀏覽器直接進入你電腦上的應用程式。

SQL Server 連線字串格式

SQL Server 的驅動程式都採用關鍵字=值的寫法,但關鍵字本身並不相同:ADO.NET 用的是 User ID 和 Connect Timeout,ODBC 說 Uid 和 ConnectTimeout,JDBC 說 user 和 loginTimeout,而 Go 則用 URL。它們還共用一個陷阱:連接埠寫在逗號之後(host,1433),而不是冒號,除 JDBC 和 Go 之外都是如此。

另一個讓人困惑的地方是加密。Microsoft.Data.SqlClient 4.0、ODBC Driver 18 和 JDBC Driver 10.2 預設都會加密並驗證伺服器憑證,因此多年來可用的字串在升級後開始失敗。建構器明確指出 Encrypt ,而解碼器會告訴你未設定的 Encrypt 對每個驅動程式而言的意思。

ADO.NET Microsoft.Data.SqlClient、System.Data.SqlClient、Entity Framework、Dapper

Server=sql01.example.com;Database=Sales;User ID=app_user;Password=your_password;Encrypt=True;

ODBC ODBC Driver 18 for SQL Server、pyodbc

Driver={ODBC Driver 18 for SQL Server};Server=sql01.example.com;Database=Sales;Uid=app_user;Pwd=your_password;Encrypt=yes;

JDBC Microsoft JDBC Driver for SQL Server

jdbc:sqlserver://sql01.example.com;databaseName=Sales;user=app_user;password=your_password;encrypt=true;

Go URL github.com/microsoft/go-mssqldb

sqlserver://app_user:[email protected]?database=Sales&encrypt=true

SQLAlchemy URL Python SQLAlchemy 搭配 pyodbc

mssql+pyodbc://app_user:[email protected]/Sales?driver=ODBC+Driver+18+for+SQL+Server&Encrypt=yes

Windows 驗證 (ADO.NET) 整合安全性

Server=sql01.example.com;Database=Sales;Integrated Security=True;Encrypt=True;

使用 Microsoft Entra ID 的 Azure SQL (ADO.NET) 受控識別、Azure CLI 或 Visual Studio 登入

Server=myserver.database.windows.net;Database=Sales;Authentication=Active Directory Default;Encrypt=True;

預留位置,例如 your_password 就只是這個意思:用上面的表單組出你自己的字串。更多關於把 SQLly 連上 SQL Server 的說明: 適用於 SQL Server 的 SQLly.

Microsoft.Data.SqlClient (ADO.NET) 關鍵字

關鍵字不區分大小寫,周圍的空格會被忽略;當同一個關鍵字(或其同義詞)出現兩次時,以最後一個值為準。未知的關鍵字會擲回 Keyword not supported。將值以 " 或 ' 當它包含 ;引用;在引號內,將引號字元加倍。

關鍵字同義詞預設其作用
Server Data Source、Address、Addr、Network Address - host, host\instance, host,port,或 tcp:host,port. . 和 (local) 意思是這台機器; (localdb)\MSSQLLocalDB 是 LocalDB。可以透過 UDP 1434 上的 SQL Server 瀏覽器找到命名執行個體。
Database 初始目錄 該登入的預設資料庫 連線後要使用的資料庫。
User ID UID、User - SQL 登入,或以下方式的 Entra 使用者名稱: Active Directory Password / Interactive.
Password PWD - 被忽略時 Integrated Security 已開啟。
Integrated Security 受信任的連線 假 true, yes 或 sspi 以正在執行此程序的 Windows 帳戶登入(Kerberos 或 NTLM)。
Authentication - 未設定 Sql Password, Active Directory Integrated, Active Directory Interactive, Active Directory Default, Active Directory Managed Identity (別名 Active Directory MSI), Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Workload Identity (5.2+), Active Directory Password (已淘汰)。從 7.0 開始,Entra 方法需要 Microsoft.Data.SqlClient.Extensions.Azure 套件。
Encrypt - true (強制)在 4.0 以上; false 在 3.x 及更早版本 true/yes/Mandatory, false/no/Optional,或 Strict (5.x 以上、TDS 8.0: SQL Server 2022+ 與 Azure SQL)。搭配 Optional 登入封包仍然是加密的,其餘的則不是。
TrustServerCertificate 信任伺服器憑證 假 true 跳過憑證驗證。與下列值併用時會被忽略(視為 false) Encrypt=Strict.
HostNameInCertificate 憑證中的主機名稱 - 5.0+。伺服器憑證中應預期的名稱,當它不同於 Server例如,當通過別名或 IP 位址連線時。
ServerCertificate 伺服器憑證 - 5.1+。伺服器憑證必須完全符合的憑證檔案路徑。
Connect Timeout 連線逾時,逾時 15 等待連線的秒數,超過即失敗。
Command Timeout - 30 2.1+。預設值 SqlCommand.CommandTimeout 以秒為單位;0表示永遠等待。
Application Name 應用程式 Core Microsoft SqlClient Data Provider (.NET) 顯示為 program_name 在 sys.dm_exec_sessions 並在 Profiler / Extended Events 中出現。
ApplicationIntent 應用程式意圖 讀寫 ReadOnly 會路由至可用性群組的可讀次要複本,或 Azure SQL 的唯讀複本。
MultiSubnetFailover 多重子網路容錯移轉 假 設為 true 連線到跨子網的可用性群組接聽程式時,可加快容錯移轉。
MultipleActiveResultSets 多重活動結果集 假 MARS:一條連線上有多個開啟的讀取作業。
Pooling - 真 連線池機制。
Max Pool Size - 100 每個不同連線字串的最大連線池連線數。
Min Pool Size - 0 連線池中保持開啟的連線。
ConnectRetryCount 連線重試次數 1 閒置連線中斷後,可嘗試重新連線 0 到 255 次。
ConnectRetryInterval 連線重試間隔 10 這些嘗試之間的時間為 1 到 60 秒。
Persist Security Info PersistSecurityInfo 假 true 會讓密碼以可讀的形式留在 ConnectionString ,開啟連線之後也是如此。請保持停用。

ODBC Driver 18 for SQL Server 關鍵字

pyodbc、R、PHP、Excel 以及其他任何使用 ODBC 的工具都用它。含有特殊字元的值必須用引號包覆([]{}(),;?*=!@)用大括號括住。和 ADO.NET 不同,當關鍵字重複出現時,以第一次出現者為準。

關鍵字同義詞預設其作用
Driver - - {ODBC Driver 18 for SQL Server} (或 17)。必須與驅動程式管理員列出的名稱相符。
Server 位址, 位址 - [tcp:]host[\instance][,port].
Database - 登入預設 資料庫名稱。
UID / PWD - - SQL 登入名稱和密碼。
Trusted_Connection - 否 yes 使用 Windows 驗證。
Authentication - - SqlPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (Windows), ActiveDirectoryMsi, ActiveDirectoryServicePrincipal, ActiveDirectoryPassword (已淘汰)。沒有 ActiveDirectoryDefault 在 ODBC 中。
Encrypt - 是(Driver 18),否(17 及更舊版本) yes/mandatory, no/optional, strict (18.1.2.1+).
TrustServerCertificate - 否 yes 跳過憑證驗證;與下列值併用時會被忽略 Encrypt=strict.
HostnameInCertificate - - 18.0 及以上版本。預期的憑證主機名稱。
ServerCertificate - - 18.1 及以上版本。伺服器憑證必須符合的憑證檔案。
ConnectTimeout - 15 18.7 及以上版本。以秒為單位的登入逾時;0 表示無限制。舊版驅動程式只接受 SQL_ATTR_LOGIN_TIMEOUT 從程式碼中設定。
APP - - 應用程式名稱。
ApplicationIntent - 讀寫 ReadOnly 用於可讀的次級伺服器。
MultiSubnetFailover - 否 Yes 用於多子網可用性群組。

Microsoft JDBC Driver for SQL Server 屬性

URL 格式: jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value...]。屬性名稱不分大小寫。值若包含 ; 要放在大括號內;從驅動程式 8.4 起,大括號內的右大括號要寫成兩個: password={pass;}}word}.

關鍵字同義詞預設其作用
databaseName 資料庫 - 資料庫名稱。
user 使用者名稱 - 登入名稱。
password - - 密碼。
integratedSecurity - 假 Windows 驗證。在 Windows 上需要 mssql-jdbc_auth-<version>.dll;在其他地方加上 authenticationScheme=JavaKerberos.
authentication - 未指定 SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (9.2+), ActiveDirectoryServicePrincipal (9.2+), ActiveDirectoryManagedIdentity (12.2+; ActiveDirectoryMSI 之前)。
encrypt - true(10.2+);false(9.4 及更早) true, false,或 strict (11.2+).
trustServerCertificate - 假 true 跳過憑證驗證。
hostNameInCertificate - - 預期的憑證主機名稱。
serverCertificate - - 11.2+。要比對的憑證檔案,搭配 strict 使用。
loginTimeout - 30(11.2+)、15(較舊版本) 等待登入的秒數。
queryTimeout - -1(無限制) 預設查詢逾時秒數。
applicationName - Microsoft JDBC Driver for SQL Server 應用程式名稱。
applicationIntent - 讀寫 ReadOnly 用於可讀的次級伺服器。
multiSubnetFailover - 假 多重子網路可用性群組。
instanceName - - 具名執行個體,做為 host\instance 放在 URL 中。

go-mssqldb URL 參數

URL 格式: sqlserver://user:password@host:port?database=... 或 sqlserver://user:password@host/instance?...。路徑是執行個體名稱,絕不會是資料庫。使用者和密碼裡的特殊字元要做百分比編碼。參數名稱不分大小寫。

關鍵字同義詞預設其作用
database - - 資料庫名稱。
encrypt - false(僅登入封包) strict, disable (完全不使用 TLS), false, true。請注意,預設值和微軟自家的驅動程式不同。
TrustServerCertificate - 有設定 encrypt 時為 false,未設定時為 true true 跳過憑證驗證。
app name - go-mssqldb 應用程式名稱(在 URL 中寫成 app+name 或 app%20name )。
connection timeout - 0(無) 整個連線允許的秒數。
dial timeout - 每個已註冊協定 15 秒 建立 TCP 連線允許的秒數。
fedauth - - Entra 方法 (ActiveDirectoryDefault, ActiveDirectoryManagedIdentity, ActiveDirectoryPassword, ...) 與 azuread 套件及 azuresql 驅動程式名稱。

常見的 SQL Server 連線錯誤

The certificate chain was issued by an authority that is not trusted.

原因: Microsoft.Data.SqlClient 4.0+、ODBC Driver 18 和 JDBC 10.2+ 預設會加密並驗證伺服器憑證。伺服器使用其自動產生的自簽署憑證,或你電腦未信任的私有 CA 憑證。

修正此問題: 在伺服器上安裝來自受信任 CA 的憑證(或在客戶端信任你的內部 CA)。如果憑證有效但屬於另一個名稱,請設定 HostNameInCertificate。僅限本機開發伺服器, TrustServerCertificate=True 就能開始上手。

Login failed for user 'app_user'. (Error 18456)

原因: 密碼錯誤、在只允許 Windows 驗證的伺服器上改用 SQL 登入、登入被停用,或登入無法開啟其預設資料庫。伺服器記錄檔會以狀態編號記下真正原因。

修正此問題: 請檢查密碼,如果使用 SQL 登入,請啟用 SQL Server 與 Windows 驗證模式,並設定 Database 改成登入有權開啟的資料庫。伺服器錯誤記錄檔中的狀態(例如 State 8 = 密碼錯誤、State 38 = 資料庫無法使用)能精確指出原因。

Keyword not supported: 'host'.

原因: Microsoft.Data.SqlClient 只接受它自己的關鍵字。 Host, Username 和 Port 是 Npgsql/MySQL 關鍵字; Provider= 屬於 OLE DB 連線字串;像 Databse 這樣的拼寫錯誤會導致同樣的失敗。

修正此問題: 使用 Server, User ID,而且 host,port。把字串貼進上方的解碼器:每個未知的關鍵字都會被標出來。

Format of the initialization string does not conform to specification starting at index 42.

原因: 一個值包含 ; 或引號但未加引號,所以解析器會在錯誤的位置拆分字串。密碼通常是罪魁禍首。

修正此問題: 用雙引號把值括住,並將內部的雙引號寫兩次: Password="p;a""ss"。建置器會替你把值跳脫好。

The target principal name is incorrect. Cannot generate SSPI context.

原因: 整合安全性使用 Kerberos,而 SQL Server 服務的服務主體名稱(SPN)缺失、重複或註冊於其他帳戶,或者你是透過 IP 位址或別名連線。

修正此問題: 使用伺服器的完全限定名稱連線,並請管理員註冊 SPN(setspn -L <service account> 列出它們)。如果憑證名稱不符合,也請檢查 HostNameInCertificate.

SQL Server 連線字串常見問題

SQL Server 的預設連接埠是多少?

預設執行個體是 1433。命名執行個體通常使用動態連接埠,SQL Server Browser (UDP 1434) 會告訴客戶端,這就是為什麼 host\instance 可以在沒有指定連接埠的情況下運作。在 ADO.NET 和 ODBC 中,連接埠位於逗號之後: Server=host,1433.

我應該使用 Encrypt=True 還是 TrustServerCertificate=True?

使用 Encrypt=True (或者 Strict 於 SQL Server 2022 與 Azure SQL 上),並使用你的用戶端信任的憑證。 TrustServerCertificate=True 會保持流量加密,但用戶端將無法確認自己在跟誰通話,因此任何能攔截連線的人都能冒充伺服器。請只在本機開發時使用。

Microsoft.Data.SqlClient 4.0 中 Encrypt 有什麼變化?

預設適用於 Encrypt 從 false 到 true,而且驅動程式預設就會驗證伺服器憑證。ODBC Driver 18 和 JDBC Driver 10.2 也做了同樣的改變。沒有 Encrypt 關鍵字,過去可以在不使用 TLS 的情況下連線,現在則需要伺服器具備受信任的憑證。

如何使用 Microsoft Entra ID 連線到 Azure SQL Database?

新增 Authentication=Active Directory Default (會挑選受控識別、環境憑證,或你的 Azure CLI / Visual Studio 登入)並省略密碼。使用 Active Directory Managed Identity 在 Azure 託管的應用程式中,以及 Active Directory Interactive 用於瀏覽器登入。Azure SQL 不接受 Integrated Security=SSPI.

Data Source 和 Server,或 Initial Catalog 和 Database 有什麼差別?

沒有差別。在 Microsoft.Data.SqlClient 中,它們是同義詞,以下這些也是: User ID / UID / User 和 Password / PWD。如果兩種寫法都出現,以最後一個為準。

System.Data.SqlClient 使用相同的連線字串嗎?

大致是。它接受傳統的關鍵字,但不接受較新的關鍵字,例如 Command Timeout, Encrypt=Strict, HostNameInCertificate 或大多數 Authentication 值,且預設為 Encrypt=False。微軟建議改用 Microsoft.Data.SqlClient。

// 完全跳過字串

連線一次。然後只需撰寫 SQL。

SQLly 是適用於 macOS、Windows 和 Linux 的原生 SQL 工作台。把連線字串貼進連線編輯器,密碼存在系統鑰匙圈裡,就能在 SQL Server 及更多引擎上獲得結構描述感知的 IntelliSense。