設定 ODBC 連線至 Microsoft SQL

透過選擇儲存 ODBC 連線的設定位置、要連接的資料庫、如何驗證以及如何保護連線來設定 ODBC 連線。 只有在部署需要時才新增路由、復原或應用程式專屬設定。

本指南說明 Windows、Linux 及 macOS 上 Microsoft ODBC Driver for SQL Server 的這些選項。 ODBC Driver 18 是目前的主要版本;ODBC Driver 17 仍是受支援的目標。 範例中使用驅動程式 18,並標示驅動程式 17 中不同的設定。 使用 關鍵字與屬性參照 查詢所有被接受的關鍵字、數值及平台。

選擇連接方法

連接字串 會為驅動程式提供keyword=value;鍵值組。 資料來源名稱(DSN)會另外儲存連線設定,讓應用程式能以名稱參照它們。 兩種方法都使用相同的驅動程式、驗證方法及資料庫權限。

Method 何時使用它 應用程式提供的內容
無需 DSN 將設定與應用程式放在一起,例如在部署配置或容器中。 你不需要在每個客戶端都建立 DSN。 Driver、Server、Database、驗證,以及其他連線設定。 驅動程式仍須安裝。
使用者 DSN 為單一作業系統使用者設定桌面應用程式,或設定需要指定資料來源的應用程式。 DSN=<data_source_name> 以及連線時提供的任何設定,包括憑證。 只有該使用者的應用程式可以使用使用者的 DSN。
系統 DSN 讓以不同身份(例如服務帳戶)執行的應用程式使用機器層級的設定。 DSN=<data_source_name> 以及連線時設定。 程序必須能存取系統 DSN 及其驅動程式。
檔案 DSN 請使用預期在 .dsn 檔案中有連線設定的應用程式。 FileDSN=<file_path> 以及連線時設定。 這個檔案不會安裝驅動程式,也不會讓其路徑在不同作業系統間可攜。

每個連線使用一種選取方法。 不要混用 DSN、Driver 和 FileDSN 來嘗試變更 DSN 的驅動程式。 服務不會自動使用您互動使用者的 DSN。

在原生應用程式中, SQLConnect 接受 DSN 以及獨立的使用者 ID 與密碼參數。 SQLDriverConnect接受 連接字串,包括 DSN 與無 DSN 表單。 使用 ODBC 的應用程式與框架會決定它們接受哪些輸入。 請依照應用程式的設定介面操作,而非假設它接受所有 ODBC 關鍵字作為命令列選項。

從 連接字串 開始

先選擇連線方式,然後在後續區段中選擇驗證及其他選項。 這些範例使用 SQL 驗證。 切換至不相容的驗證方式時,請勿保留 UID、 PWD、 Authentication=SqlPassword 。

以您自己的值取代 <server>、<database>、<user_id> 和 <password>。 對於 Azure SQL Database,請使用 <server>.database.windows.net 作為主機名稱。 範例中使用傳輸控制協定(TCP)連接埠 1433;請將其替換為您端點所設定的連接埠。

無需 DSN 即可連線

請直接提供已安裝的驅動程式名稱及連線設定:

Driver={ODBC Driver 18 for SQL Server};Server=tcp:<server>,1433;Database=<database>;UID=<user_id>;PWD=<password>;Authentication=SqlPassword;Encrypt=yes;TrustServerCertificate=no;

對於驅動程式 17,請將驅動程式名稱替換為 ODBC Driver 17 for SQL Server。 此範例中的其他設定適用於兩個主要版本。

與 DSN 連線

建立 DSN 後,請提供其名稱及應用程式的驗證設定:

DSN=MSSQLTest;UID=<user_id>;PWD=<password>;Authentication=SqlPassword;Encrypt=yes;TrustServerCertificate=no;

DSN 會選擇驅動程式、伺服器與資料庫。 範例會明確重複安全性設定,使應用程式在任一連線方式下都能請求相同的保護。

請不要將真實密碼儲存在 DSN、檔案 DSN、odbc.ini、來源檔案或 shell 指令中。 透過應用程式的認證管理機制擷取機密資訊,並在連線時提供。 將任何包含密碼、權杖或金鑰儲存密鑰的 連接字串 視為敏感資料,包括記錄檔與診斷擷取。

選擇驅動程式、伺服器及資料庫

這些設定決定應用程式載入什麼內容以及連接位置。

Setting 何時以及如何使用它
Driver 依註冊名稱選擇已安裝的驅動程式,供無 DSN 連線使用。 驅動程式 17 與驅動程式 18 名稱不同,且可並列安裝。 安裝驅動程式 18 並不會重新導向明確選擇驅動程式 17 的連線。
Server=tcp:<server>,1433 使用已知的 TCP 端點與連接埠。 逗號用來將主機名稱與連接埠分隔開。 Linux 和 macOS 僅支援 TCP。 明確指定的連接埠可避免依賴命名實例探索。
Server=<server>\<instance> 當實例發現可用時,連線至已命名的 SQL Server 實例。 在 Linux 和 macOS 上,這需要 17.4 版或更新版本的驅動程式,包括 Driver 18。 若無法進行偵測,請取得實例的 TCP 連接埠並使用明確指定連接埠的格式。
Database=<database> 請特別選擇初始資料庫,特別是針對包含的資料庫使用者或不依賴登入預設資料庫的應用程式。 此設定不會建立資料庫或授予存取權限。
Address 或 Addr 維護使用獨立網路位址的應用程式。 避免指定衝突的 Server;請選擇一個明確的端點,而非依賴名稱之間的優先順序。
Network 或 Net 維護一個明確選取網路函式庫的 Windows 設定。 偏好使用 tcp: 伺服器前綴來建立跨平台 TCP 連線。 不要將通訊協定前綴與相衝突的網路選項結合使用。

伺服器別名、命名實例、網域名稱系統(DNS)主機名稱與連接埠不可互換。 使用與加密遠端連線憑證相符的 DNS 名稱。 網際網路通訊協定(IP)位址無法避免憑證名稱不符。

對於 Azure SQL Database 及其他受管理服務,請使用該服務已發佈的端點。 對於可用性群組,當您想要 容錯移轉或唯讀路由時,請使用其監聽器,而非硬編碼複本的主機名稱。

選擇驗證

驗證方式決定哪個身分連線。 它不會授予該身份資料庫權限,也不會取代加密設定。

Method 連線設定 何時使用及先決條件
SQL 驗證 Authentication=SqlPassword、、 UID和 PWD。 目標系統啟用 SQL 驗證,且您擁有帶有密碼的 SQL 登入或資料庫使用者。 驅動程式 17 與驅動程式 18 均支援此形式。 UID是 SQL 使用者名稱,而非 Microsoft Entra ID 帳戶。
Windows 整合式驗證 Trusted_Connection=yes;省略 UID 和 PWD。 使用程序的 Windows 身分,用於設定為 Windows 驗證 的目標。 在 Linux 和 macOS 上,設定 Kerberos 並取得應用程式身分的票證。 這不是 Microsoft Entra 的整合式認證。
Microsoft Entra 整合式驗證 Authentication=ActiveDirectoryIntegrated;省略 SQL 憑證。 在支援整合驗證的 Microsoft Entra 設定中使用現有的 Windows 或 Kerberos 身份。 Linux 和 macOS 需要驅動程式 17.6 及更新版本,包括驅動程式 18。
Microsoft Entra 互動式驗證 Authentication=ActiveDirectoryInteractive;省略 PWD。 使用者可以完成登入及多重要素驗證。 支援 Windows,包括驅動程式 17.1 及更新版本。 對於驅動程式 17.1 至 17.7,請在 UID中提供 Microsoft Entra 使用者名稱。 驅動程式 17.8 及更新版本(包括驅動程式 18)允許您省略 UID。 請勿在無人值守服務中使用此方法。
Microsoft Entra 受控識別身分 Authentication=ActiveDirectoryMsi。 在公開受支援受控識別端點的主機上執行。 系統指派的身份不需要 UID。 使用者指派的身分識別必須使用適合該主機的識別碼搭配 UID。 提供於驅動程式 17.3.1.1 及更新版本,包括驅動程式 18。
Microsoft Entra 服務主體 Authentication=ActiveDirectoryServicePrincipal; UID 是應用程式的用戶端 ID,且 PWD 是其用戶端密鑰。 無人值守應用程式使用Microsoft Entra應用程式身份,而管理身份並不適用。 此功能適用於 Driver 17.7 及更新版本,包括 Driver 18。 保護並輪換用戶端密鑰。
應用程式提供的 Microsoft Entra 存取權杖 在連線前設定 SQL_COPT_SS_ACCESS_TOKEN 連線屬性。 應用程式自行取得該代幣。 這是應用程式介面(API)屬性,而非 連接字串 關鍵字。 在連線配置中省略 UID、 PWD、 Trusted_Connection、 Authentication 。

只有當目標支援 Microsoft Entra 方法且您已設定身份的資料庫存取權限時,才可選擇該方法。 驅動程式所支援的方法不一定在每一個 SQL Server 部署或受管理服務中都提供。 關於設定、主機專屬的管理身份識別碼及平台限制,請參閱〈使用 Microsoft Entra ID 搭配 ODBC 驅動程式〉及〈在 Linux 和 macOS 上使用整合式驗證〉。

不要將Authentication與Trusted_Connection=yes值結合使用。 不要在 PWD 中放置存取權杖。 變更 DSN 的驗證方法時,請移除不相容的認證與應用程式屬性,並更改關鍵字。

ActiveDirectoryPassword使用 Microsoft Entra 使用者名稱與密碼,且已棄用。 不要為新的應用程式選擇它。 建議使用適合互動式使用者或工作負載身分的方法。

配置加密與憑證驗證

使用 Encrypt=yes;TrustServerCertificate=no 建立傳輸層安全性(TLS)連線,並使用 Driver 17 或 Driver 18 驗證伺服器憑證。 用戶端必須信任簽發憑證的憑證授權單位,且憑證必須符合預期的伺服器名稱。

Configuration 何時使用它 驅動程式 17 與驅動程式 18 的行為
Encrypt=yes;TrustServerCertificate=no 要求加密及一般憑證驗證。 兩個主要版本皆支援。 驅動程式 18 也接受 mandatory 作為 yes 的同義詞。
Encrypt=strict 要求對支援該功能的端點使用 Tabular Data Stream (TDS) 8.0 加密。 僅限 Driver 18。 驅動程式驗證憑證並忽略 TrustServerCertificate。 Driver 17 沒有對應項目。
Encrypt=yes;TrustServerCertificate=yes 一個經過刻意核准的例外,可在不進行一般憑證驗證的情況下加密流量。 不要把它當成憑證錯誤的例行修復方法。 它並不能確認客戶端正在與目標伺服器通訊。 它不會在嚴格模式下停用驗證。
Encrypt=no 維持不需要用戶端進行完整會話加密的設定。 這不是遠端連線的基準。 驅動程式 18 也接受 optional。 伺服器仍可要求加密。

驅動程式 18 預設為請求加密。 驅動程式 17 通常預設不請求加密,但非空 Authentication 設定或提供的存取權杖會改變驅動程式 17 的加密預設值。 明確設定 Encrypt,而非依賴依驗證而定的預設值。

對於一般非嚴格連線,且為 Encrypt=noTrustServerCertificate=no,伺服器專用加密請求會讓驅動程式 18 驗證憑證,但不會在驅動程式 17 中選擇一般憑證驗證。 不要只依賴伺服器強制加密來在兩個驅動程式中取得相同的驗證行為。 如需完整與伺服器設定的互動,請參閱 加密行為表。

選擇預期的憑證識別碼

大多數應用程式只需要受信任的憑證和正確的 Server 名稱即可。 針對特定部署需求使用額外的憑證關鍵字:

Keyword 何時使用它 適用性與限制
HostnameInCertificate 部署需要與連線端點不同的預期憑證主機名稱,例如已設定的別名。 僅限 Driver 18。 它並不能建立對不受信任的發行權威的信任。 當使用 ServerCertificate 時,它會被忽略。
ServerCertificate 比對明確分發的伺服器憑證檔案,而非一般的憑證鏈與主機名稱驗證。 驅動程式 18.1 及更新版本,僅限搭配 Encrypt=strict 使用。 請使用隱私增強郵件(PEM)或辨別編碼規則(DER)憑證。 憑證必須完全匹配,且有效日期仍需檢查。 規劃如何在伺服器憑證輪替前分發替換版本。
ClientCertificate 以及 ClientKey 使用專用的憑證驗證機制來迴環連線至 Linux 上的 SQL Server。 這些不是 SQL 或 Microsoft Entra 驗證的通用替代品,也不是伺服器憑證信任設定。

解決憑證鏈、主機名稱及憑證檔案問題,而非停用驗證。 在 Linux 和 macOS 上,也請檢查驅動程式支援的 OpenSSL 相依性以及該程序所使用的信任儲存庫。 如需更多資訊,請參閱「 連線加密疑難排解」。

Linux 與 macOS 憑證信任

Linux 和 macOS 上的 TLS 使用 OpenSSL。 取得核准的信任資料,並遵循您平台的信任儲存管理程序。 從未驗證的端點下載的憑證不足以作為信任該憑證的充分證據。 請檢查您的驅動程式與平台所支援的函式庫的 系統需求 。

以下歷史平台清冊記錄了 OpenSSL 最低版本及預設憑證信任儲存位置。 它並未說明這些平台版本目前的驅動程式支援情況。 在依賴所列出的某個位置之前,請確認您已安裝的驅動程式及平台所使用的 OpenSSL 版本及信任儲存組態。

平台 最低 OpenSSL 版本 預設憑證信任儲存位置
Debian 10、11、12 1.1.1 /etc/ssl/certs
Debian 9 1.1.0 /etc/ssl/certs
Debian 8.71 1.0.1 /etc/ssl/certs
OS X 10.11、macOS 1.0.2 /usr/local/etc/openssl/certs
Red Hat 企業版 Linux 9 3.0.1 /etc/pki/tls/cert.pem
紅帽企業版 Linux 8 1.1.1 /etc/pki/tls/cert.pem
紅帽企業Linux 7 1.0.1 /etc/pki/tls/cert.pem
紅帽企業版 Linux 6 1.0.0-10 /etc/pki/tls/cert.pem
SUSE Linux 企業版 15 1.1.0 /etc/ssl/certs
SUSE Linux Enterprise 11、12 1.0.1 /etc/ssl/certs
Ubuntu 22.04、23.04 3.0.2 /etc/ssl/certs
Ubuntu 20.04 1.1.1 /etc/ssl/certs
Ubuntu 18.04 1.1.0 /etc/ssl/certs
Ubuntu 16.04 1.0.2 /etc/ssl/certs
Ubuntu 14.04 1.0.1 /etc/ssl/certs
Alpine 3.17、3.18 3.0.1 /etc/ssl/certs

設定路由與容錯轉移

根據目標拓撲與工作負載選擇這些設定。 它們不會建立複本、設定監聽器,也不會授予次要伺服器的存取權。

Setting 何時使用它 重要區別
MultiSubnetFailover=Yes 連接至 Microsoft Fabric 中的可用性群組監聽器、容錯移轉叢集實例、Azure SQL Database、Azure SQL 受控執行個體 或 SQL 資料庫。 驅動程式會嘗試以 TCP 平行連線至已解析出的位址。 當名稱解析為某個地址時,它也有效。 它由 Driver 17 和 Driver 18 支援。 不要把它和資料庫鏡像的 Failover_Partner結合使用。
ApplicationIntent=ReadOnly 為唯讀工作負載要求連線,包括透過適當設定的可用性群組監聽器進行唯讀路由。 指定參與資料庫並設定伺服器端路由。 此設定不能取代唯讀資料庫權限。 預設值為 ReadWrite。
TransparentNetworkIPResolution 維護或診斷驅動程式在多個已解析 IP 位址間的舊版回退機制。 值為 Enabled 和 Disabled;預設值為 Enabled。 不要把這當作另一個拼法 MultiSubnetFailover。
IpAddressPreference 對於具有特定位址族群需求的部署,請選擇 IPv4 優先、IPv6 優先或作業系統位址順序。 驅動程式 18.1 及之後版本。 數值為 IPv4First、 IPv6First、 UsePlatformDefault和 。 這不會改變 DNS 紀錄或修復網路路由。
Failover_Partner 維持現有的 SQL Server 資料庫鏡像連線。 只支援 Windows。 這不是可用群組監聽器的選項。 驅動程式 18.7 及之後版本也接受別名 FailoverPartner;驅動程式 17 則使用 Failover_Partner.

對於唯讀可用性群組連線,請在適當的已驗證 連接字串 中新增ApplicationIntent=ReadOnly;MultiSubnetFailover=Yes,並使用Server中的接聽程式。 直接連線到任意次要複本並不會設定唯讀路由。

故障轉移後,應用程式可能需要開啟新的連線。 有關伺服器的先決條件與應用程式行為,請參閱 高可用性與災難復原。

設定逾時、恢復與重試行為

為您需要控制的操作選擇一項設定。 登入逾時、查詢逾時、閒置連線恢復政策及指令重試政策適用於不同操作。

需求 Setting 何時以及如何使用它
限制連線建立。 SQL_ATTR_LOGIN_TIMEOUT,或 ConnectTimeout 搭配 Driver 18.7 及更新版本。 在原生應用程式中,請在連線前設定該屬性。 Driver 17 及更早版本,以及 Driver 18 版本需要使用屬性,而非此關鍵字。 明確設定的屬性優先於 ConnectTimeout。
限制陳述式執行。 SQL_ATTR_QUERY_TIMEOUT statement 屬性。 透過應用程式的 API 進行設定。 ConnectTimeout 不會設定查詢逾時。
恢復閒置時中斷的符合資格的連線。 ConnectRetryCount 以及 ConnectRetryInterval。 由目前的 Driver 17 與 Driver 18 版本支援。 預設為一次復原嘗試,兩次嘗試間隔 10 秒。 計數為 0 時會停用復原功能。 這些設定不會重試應用程式的初始連線,也不會重播其指令。
偵測已不再回應的閒置 TCP 連線。 KeepAlive 以及 KeepAliveInterval。 只針對實際測量的網路需求進行調校。 預設時間為 30 秒與 1 秒。 驅動程式 17.4 引入了設定支援;連接字串 支援需要驅動程式 17.8 及更新版本,包括驅動程式 18。 較早支援的版本使用 DSN 或驅動程式設定。
重新執行選取的失敗指令。 RetryExec。 驅動程式 18.1 及之後版本。 只有在決定重複操作是否安全後,才為特定錯誤與指令定義規則。 這不是閒置連線恢復。

例如, ConnectRetryCount=3;ConnectRetryInterval=2 最多可選擇三次閒置恢復嘗試,間隔為 2 秒。 它不會讓初次登入失敗變成成功,也不會重試中斷的寫入。

ConnectRetryCount接受 0 到 1,而 ConnectRetryInterval接受 255 到 60 秒。 在驅動程式 18.7 及更新版本中,ConnectTimeout=30 會要求 30 秒的登入逾時。 預設為 15 秒;0 表示無限期等待。 當應用程式需要有限回應時間時,避免無限期的登入等待。

針對短暫初始連線失敗實施有界的應用程式重試政策。 不要把錯誤的登入認證資訊、缺少驅動程式註冊或憑證驗證錯誤當成暫時性中斷來重試。 對於指令重試,請考慮伺服器是否在連線失敗前已完成寫入。

有關復原先決條件與錯誤處理,請參閱 連線韌性。 關於規則語法,請參閱 RetryExec。 保持連線與查詢逾時選項與您的應用程式可接受的總延遲相符。

Linux 與 macOS 的 keep-alive 設定

KeepAlive 控制 TCP 傳送封包以檢查閒置連線的頻率。 KeepAliveInterval 控制在沒有回應時重傳之間的間隔。 其預設值分別為 30 秒和 1 秒。

在驅動程式 17.4 及更新版本中,您可以在驅動程式區段 odbcinst.ini 或 DSN 區段 odbc.ini設定這些值。 使用 DSN 連線時,DSN 的設定優先於驅動程式的設定。 在沒有 DSN 的情況下,驅動程式會使用其在 odbcinst.ini 中的區段。 如果兩個位置都未指定值,驅動程式會使用預設值。

驅動程式 17.8 及更新版本,包括驅動程式 18,也接受 KeepAlive 與 KeepAliveInterval 包含在 連接字串 中。 取代現有關鍵字,而非附加重複的關鍵字,並在與 DSN 合併連線時間設定時檢視設定優先順序。

設定應用程式與資料行為

當應用程式需要該行為時,請使用這些選項,而非將這些選項新增至每個 連接字串。

Setting 何時使用它 行為與限制
APP 在伺服器端工作階段資訊中識別該應用程式。 請使用穩定的應用程式名稱。 它不是經過驗證的身分或授權控制。
WSID 當您需要工作站識別碼以進行會話識別時,請提供工作站識別碼。 驅動程式 18.7 及更新版本也支援 WorkstationID。 驅動程式 17 使用 WSID。 不要用客戶提供的名稱作為呼叫者身分的證明。
MARS_Connection=Yes 應用程式需要在單一連線上有多個主動結果集(MARS)。 預設值為 No。 驅動程式 18.7 及更新版本也支援 MultipleActiveResultSets=Yes。 驅動程式 17 使用 MARS_Connection。
LongAsMax=Yes 將長字元或二進位參數以 varchar(max)、nvarchar(max) 或 varbinary(max) 傳送,取代舊有大型物件類型。 僅限驅動程式 18;預設為 No。 變更應用程式前,請先檢查其參數與綱要預期。
GetDataExtensions=Yes 維護需要以 SQLGetData 非依序擷取欄位資料的應用程式。 僅限 Driver 18。 這種相容行為可能會增加記憶體使用量並降低效能。 在新應用程式中,偏好依升序擷取欄位。
Language 選擇工作階段的伺服器訊息語言。 使用伺服器上安裝的語言。 它不會選擇應用程式的原始碼編碼。
AutoTranslate 控制非 Unicode 字元資料在用戶端與伺服器程式碼頁間的轉換。 預設值為 Yes。 在更改應用程式的實際字元資料前,請先測試;停用翻譯可能會改變字元的解讀方式。
Regional 使應用程式在將貨幣、日期或時間資料轉換為字元資料時,維持預期採用用戶端區域格式。 預設值為 No。 不要以為改變輸出格式就代表那些地區設定字串是有效的輸入參數。
AnsiNPW 維持 Session 行為以處理 null 處理、字元填補及警告。 預設值為 Yes。 在變更之前,請先檢視對應的 Transact-SQL(T-SQL)工作階段選項及伺服器版本行為。
QuotedId 控制工作階段是否使用雙引號作為識別碼。 預設值為 Yes。 只有當應用程式的 T-SQL 需要不同的 QUOTED_IDENTIFIER 行為時才更改。
ConcatNullYieldsNull 控制伺服器支援該工作階段選項之 NULL 串接行為。 驅動程式 18.6 及之後版本。 驅動程式 17 無法辨識這個關鍵詞。
UseFMTONLY 維持一條需要 SET FMTONLY 而非驅動程式一般中繼資料探索的中繼資料探索路徑。 預設值為 No。 對於一般連線而言,這不是必要的。

透過驅動程式管理員或應用程式的 ODBC 環境設定連線池。 請勿將其他提供者的Pooling關鍵字複製到此驅動程式的 連接字串 中。 有關原生 ODBC 設定,請參閱驅動程式管理員連線共用。 關於 Windows 專屬的重用行為,請參閱 驅動程式相關連線池。

設定專用功能

下列選項需要在 連接字串 之外進行功能專屬設定。

Settings 何時使用它們 還需要哪些項目
ColumnEncryption=Enabled 讀取或寫入受 Always Encrypted 保護的欄位。 透過支援的金鑰儲存庫存取欄位加密金鑰。 Always Encrypted 保護欄位值,且與網路加密是分開的。 對於 enclave 連線,請使用功能專屬的連線設定。
KeystoreAuthentication、KeystorePrincipalId和KeystoreSecret 讓驅動程式向用於 Always Encrypted 的金鑰儲存庫進行驗證。 金鑰存放區的身分識別與權限。 這些憑證並不是資料庫登入憑證。 像保護密碼一樣保護金鑰儲存的機密。
ServerSPN 為需要明確值的 Kerberos 部署指定服務主體名稱(SPN)。 目前的驅動程式 17 與驅動程式 18 版本支援此設定,適用於 Windows、Linux 和 macOS。 將 Kerberos 服務註冊設定為與所提供的 SPN 相符。 SPN 並不是 TLS 憑證主機名稱。
FailoverPartnerSPN 為資料庫鏡像夥伴維護明確的 Kerberos SPN。 僅限 Windows,並具備相應的鏡像設定。
AttachDBFileName 使用附加資料庫檔案的 SQL Server 工作流程。 相符的 Database 名稱、伺服器可存取的檔案,以及所需的權限。 不要用它來識別 Azure SQL Database 中的現有資料庫。
Replication=Yes 使用一個刻意需要複寫代理行為的連線。 Driver 17.8 及之後版本,包括 Driver 18。 它會改變標記為 NOT FOR REPLICATION 的物件行為,包括觸發器;這並非一般效能選項。
QueryLog_On、 QueryLogFile、 QueryLogTime、 StatsLog_On、以及 StatsLogFile 透過驅動程式查詢或效能記錄來診斷現有的 Windows 應用程式。 僅限 Windows;這些連線設定需要 DSN。 以毫秒為單位設定慢查詢閾值 QueryLogTime。 使用受控的記錄目的地、適當的權限以及保留政策。 不要把診斷日誌當作沒有敏感資料。

關於設定與限制,請參閱 Always Encrypted、Kerberos SPNs 和 關鍵字參考。 某些原生功能,例如分散式交易登錄,需要 API 屬性而非 連接字串 關鍵字。

建立 DSN

僅在選擇基於 DSN 的連線時建立 DSN。 DSN 會儲存設定;儲存它並不代表應用程式能通過驗證或執行查詢。

Windows 使用者 DSN

以下程序為 SQL 驗證範例建立使用者 DSN。 對於某項服務,請刻意改為選擇 System DSN,並在服務身分下安排存取。

  1. 開啟與您應用程式架構相符的 ODBC 資料來源管理員。

  2. 在 使用者 DSN 上,選擇 新增。

  3. 選擇 ODBC Driver 18 for SQL Server 或 ODBC Driver 17 for SQL Server。 選擇 「完成 」以開啟驅動程式精靈。

  4. 將 DSN 命名為 MSSQLTest。 在伺服器欄位中輸入 tcp:<server>,1433,然後選擇 下一步。

  5. 選擇 SQL 驗證。 清除 登入 ID 和 密碼,然後選擇 下一步。

  6. 勾選「將預設資料庫變更為」。 在不開啟資料庫清單的情況下輸入 <database>,然後選擇 「下一步」。

  7. 在驅動程式 18 中,選擇 Mandatory 連線加密。 在驅動程式 17 中,選擇「對資料使用強加密」。 請勿勾選 信任伺服器憑證。

  8. 選擇 「完成 」並檢視設定摘要。

  9. 選擇 「確定」 以儲存 DSN,而不執行精靈的連線測試。 確認 MSSQLTest 顯示在 使用者 DSN 上。

應用程式會在連線時提供 SQL 憑證。 關於其他驗證方法與精靈欄位,請參閱 ODBC 資料來源管理員 DSN 選項。

Linux 或 macOS 使用者 DSN

執行 odbcinst -j 以尋找您 unixODBC 安裝的 USER DATA SOURCES 與 SYSTEM DATA SOURCES 路徑。 將以下區段新增至使用者檔案,並將伺服器和資料庫預留位置中的內容替換為實際值:

[MSSQLTest]
Driver = ODBC Driver 18 for SQL Server
Server = tcp:<server>,1433
Database = <database>
Authentication = SqlPassword
Encrypt = yes
TrustServerCertificate = no

對於驅動程式 17,變更驅動程式名稱。 不要儲存 PWD 在這個檔案裡。 在 odbcinst.ini 中的驅動程式註冊,以及 odbc.ini 中的 DSN,用途不同:一個用來定位驅動程式庫,另一個則用來命名連線設定。

對於系統 DSN,請以系統管理員權限將相同設定新增至已報告的 SYSTEM DATA SOURCES 檔案。 對於某項服務,請在服務身分下安排存取。

該 Driver 值可以是已註冊的驅動程式名稱,或安裝範本中指定的驅動程式庫路徑。 在 odbc.ini中,使用不加連接字串大括號的註冊名稱。 請在 Server 中指定伺服器連接埠;Port 在 Linux 或 macOS 上不是此驅動程式有效的 DSN 關鍵字。

或者,將 DSN 區段儲存在範本檔中,並使用以下指令註冊使用者 DSN:

odbcinst -i -s -h -f <template_file>

以範本路徑取代 <template_file> 。 有關 .ini 檔案與註冊的詳細資訊,請參閱 unixODBC 文件。 透過使用 DSN 的應用程式測試連線;僅僅註冊並不會建立資料庫連線。

檔案 DSN

當應用程式預期檔案資料來源時使用 FileDSN=<file_path> 。 客戶端仍然需要安裝一個能解讀設定的驅動程式。 將認證資訊放在檔案之外。

SaveFile 會要求在連線成功後將連線設定儲存到檔案中。 僅在應用程式刻意建立 DSN 檔案時使用此功能。 有關檔案內容與合併規則,請參閱 SQLDriverConnect 參考。

了解設定優先順序

應用程式可以從 DSN、其 連接字串 和 API 屬性接收設定。 當有效連線與你預期的連線字串不同時,請檢查這三者。

來源或語法 規則
關鍵字拼寫 驅動程式會匹配關鍵字名稱,不以大小寫為準。 接受的值是關鍵字特定的;不要假設每個布林選項都接受 true 和 false。
重複關鍵字 在解析驅動程式選項時,驅動程式 17 與驅動程式 18 會保留已辨識之關鍵字的首次出現。 同一選項的別名不會提供獨立的覆寫。 此規則不管驅動程式管理員先前的驅動程式或 DSN 選擇:unixODBC 在該階段會使用重複出現的 DSN 或 Driver 值中的最後一次出現。 取代現有值,而不是附加重複值,且只指定一次選取關鍵字。
connection string 與 DSN 的比較 明確的 連接字串 值通常會覆寫對應的 DSN 欄位。 驅動程式的 RegPrecedence DSN 設定可以顛倒此優先順序。 當現有的 DSN 出現異常行為時,請檢查它。
API 屬性 應用程式設定的屬性可能會改變有效配置。 請檢查該特定屬性的合約,而不是假設每個屬性都使用相同的合併規則。
大括號括住的值 將包含分號的值以大括號括起來,並在該值內將右大括號寫成兩個。 例如,Database={database;name} 代表一個資料庫名稱。 Shell 或程式語言的引號處理與 ODBC 轉義是分開的。

在 DSN 與應用程式間保持驗證與安全性設定一致。 變更驅動程式時,請依需要更新 DSN 所選的驅動程式,或 DSN-less Driver 值。 有關遷移檢查,請參閱「主要版本差異」。

在您的應用程式中檢查連線狀況

依應用程式實際作業系統識別碼與部署設定進行測試。 成功的 DSN 精靈測試並不證明服務能看到相同的 DSN 或取得相同的憑證。

  1. 使用所選的 DSN 或無 DSN 字串及預期的驗證方式連線。
  2. 連線成功後,確認應用程式載入的是哪個驅動程式及版本。 在原生程式碼中,請使用 SQLGetInfo 與 SQL_DRIVER_VER 與 SQL_DRIVER_NAME。
  3. 在目標資料庫中執行查詢並檢查結果。 如需完整的應用程式範例,請參閱 使用 C++ 連線並查詢資料庫。
  4. 檢查加密以及應用程式所需的行為,例如唯讀路由或復原。 測試您獨立部署的每種連線方式。
  5. 擷取失敗資訊而不暴露憑證。 關於 SQLSTATE 值、原生錯誤代碼及受保護的診斷資料收集,請參閱 ODBC 診斷。

如果連線失敗,請在變更驗證前檢查驅動程式註冊與 DSN 可見性。 在更改重試設定前,請檢查端點與可達性。 對於憑證錯誤,請修正信任或名稱設定,而非設定 TrustServerCertificate=yes 讓錯誤消失。