共用方式為


搭配 SQL Server Native Client 使用連接字串關鍵字

某些 SQL Server Native Client API 會使用連接字串來指定連接屬性。 連接字串是關鍵字和關聯值的清單,每一個關鍵字都會識別特定的連接屬性。

[!附註]

SQL Server Native Client 允許模稜兩可的連接字串,以維護回溯相容性 (例如,某些關鍵字可能會指定一次以上,而且可能會允許衝突的關鍵字,好讓解決方法以位置或優先順序為根據)。 未來的 SQL Server Native Client 版本可能不允許模稜兩可的連接字串。 當修改應用程式,以便使用 SQL Server Native Client 來移除對於模稜兩可之連接字串的任何相依性時,這就是很好的作法。

下列章節描述當使用 SQL Server Native Client 當做資料提供者時,可以搭配 SQL Server Native Client OLE DB 提供者、SQL Server Native Client ODBC 驅動程式和 ActiveX Data Objects (ADO) 使用的關鍵字。

ODBC 驅動程式連接字串關鍵字

ODBC 應用程式會使用連接字串當做 SQLDriverConnectSQLBrowseConnect 函數的參數。

ODBC 使用的連接字串具有以下語法:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

可以選擇用大括號括住屬性值,這樣是很好的作法。 如此可在屬性值包含非英數字元時避免問題發生。 值中的第一個右大括號應該會結束該值,所以值不能包含右大括號字元。

下表描述可搭配 ODBC 連接字串使用的關鍵字。

關鍵字

說明

Addr

"Address" 的同義字。

Address

執行 SQL Server 執行個體之伺服器的網路位址。 雖然 Address 通常是伺服器的網路名稱,不過也可能是其他名稱,例如管道、IP 位址,或 TCP/IP 通訊埠和通訊端位址。

若您指定 IP 位址,請確定在 SQL Server 組態管理員中已啟用 TCP/IP 或具名管道通訊協定。

當使用 SQL Server Native Client 時,Address 的值優先於 ODBC 連接字串中傳遞給 Server 的值。 同時請注意,Address=; 將會連接到 Server 關鍵字中指定的伺服器,而 Address= ;, Address=.;、Address=localhost; 和 Address=(local); 都會造成與本機伺服器的連接。

Address 關鍵字的完整語法如下:

[protocol:]Address[,port |\pipe\pipename]

protocol 可以是 tcp (TCP/IP)、lpc (共用記憶體) 或 np (具名管道)。 如需有關通訊協定的詳細資訊,請參閱<設定用戶端通訊協定>。

如果沒有指定 protocol 或 Network 關鍵字,則 SQL Server Native Client 會使用在 SQL Server 組態管理員中指定的通訊協定順序。

port 是在指定的伺服器上所要連接的通訊埠。 根據預設,SQL Server 會使用通訊埠 1433。

AnsiNPW

如果為 "yes",此驅動程式就會使用 ANSI 定義的行為來處理 NULL 比較、字元資料填補、警告和 NULL 串連。 當為 "no" 時,將不會公開 ANSI 定義的行為。 如需有關 ANSI NPW 行為的詳細資訊,請參閱<ISO 選項的作用>。

APP

呼叫 SQLDriverConnect 的應用程式名稱 (選擇性)。 如果指定的話,這個值就會儲存在 master.dbo.sysprocesses 資料行 program_name 中,而且會由 sp_whoAPP_NAME 函數所傳回。

ApplicationIntent

當連接到伺服器時,宣告應用程式工作負載類型。 可能的值是 ReadOnly 和 ReadWrite。 例如:

ApplicationIntent=ReadOnly

預設值為 ReadWrite。 如需有關 SQL Server Native Client 中 AlwaysOn 可用性群組 支援的詳細資訊,請參閱<高可用性/災害復原的 SQL Server Native Client 支援>。

AttachDBFileName

可附加資料庫的主要檔案名稱。 包含完整路徑,而且會使用 C 字元字串變數逸出任何 \ 字元:

AttachDBFileName=c:\\MyFolder\\MyDB.mdf

此資料庫會附加,而且變成連接的預設資料庫。 若要使用 AttachDBFileName,您也必須在 SQLDriverConnect DATABASE 參數或 SQL_COPT_CURRENT_CATALOG 連接屬性中指定資料庫名稱。 如果之前已附加資料庫,SQL Server 不會重新附加它,它會使用附加的資料庫當做連接的預設值。

AutoTranslate

當為 "yes" 時,如果要轉譯用戶端與伺服器之間傳送的 ANSI 字元字串,則會透過 Unicode 來進行轉換,好讓用戶端與伺服器之字碼頁之間的比對擴充字元問題減至最少。

傳送到 SQL Server charvarchartext 變數、參數或資料行的用戶端 SQL_C_CHAR 資料會使用用戶端的 ANSI 字碼頁 (ACP),從字元轉換成 Unicode,然後使用伺服器的 ACP,從 Unicode 轉換成字元。

傳送到用戶端 SQL_C_CHAR 變數的 SQL Server charvarchartext 資料會使用伺服器的 ACP,從字元轉換成 Unicode,然後使用用戶端的 ACP,從 Unicode 轉換成字元。

這些轉換會由 SQL Server Native Client ODBC 驅動程式在用戶端上執行。 這會要求在伺服器上使用的相同 ANSI 字碼頁 (ACP) 必須也可以在用戶端上使用。

這些設定對於進行下列傳輸時所發生的轉換沒有作用:

  • 傳送到伺服器之 charvarchartext 的 Unicode SQL_C_WCHAR 用戶端資料。

  • 傳送到用戶端上之 Unicode SQL_C_WCHAR 變數的 charvarchartext 伺服器資料。

  • 傳送到伺服器上之 Unicode ncharnvarcharntext 的 ANSI SQL_C_CHAR 用戶端資料。

  • 傳送到用戶端上之 ANSI SQL_C_CHAR 變數的 Unicode ncharnvarcharntext 伺服器資料。

當為 "no" 時,不會執行字元轉譯。

SQL Server Native Client ODBC 驅動程式不會轉譯伺服器上傳送給 charvarchartext 變數、參數或資料行的用戶端 ANSI 字元 SQL_C_CHAR 資料。 在從伺服器傳送到用戶端之 SQL_C_CHAR 變數的 charvarchartext 資料上不會執行任何轉譯。

如果用戶端和 SQL Server 使用不同的 ACP,可能會將擴充字元解譯錯誤。

Database

用於連接的預設 SQL Server 資料庫名稱。 如果未指定 Database,就會使用針對登入所定義的預設資料庫。 ODBC 資料來源中的預設資料庫會覆寫針對此登入所定義的預設資料庫。 此資料庫必須是現有的資料庫,除非也指定了 AttachDBFileName。 如果也指定了 AttachDBFileName,則會附加它所指向的主要檔案,並為它提供 Database 所指定的資料庫名稱。

Driver

SQLDrivers 傳回的驅動程式名稱。 SQL Server Native Client ODBC 驅動程式的關鍵字值是 "{SQL Server Native Client 11.0}"。 如果指定了 Driver,而且 DriverCompletion 設定為 SQL_DRIVER_NOPROMPT,則需要 Server 關鍵字。

如需有關驅動程式名稱的詳細資訊,請參閱<使用 SQL Server Native Client 標頭檔與程式庫檔案>。

DSN

現有 ODBC 使用者或系統資料來源的名稱。 此關鍵字會覆寫任何可能在 Server、Network 和 Address 關鍵字中所指定的值。

Encrypt

指定當透過網路傳送資料以前,是否應該先加密資料。 可能的值為 "yes" 和 "no"。 預設值為 "no"。

Fallback

這個關鍵字已被取代,而且 SQL Server Native Client ODBC 驅動程式會忽略它的設定。

Failover_Partner

當無法連接主要伺服器時,所要使用的容錯移轉夥伴伺服器名稱。

FailoverPartnerSPN

容錯移轉夥伴的 SPN。 預設值為空字串。 空字串會讓 SQL Server Native Client 使用驅動程式產生的預設 SPN。

FileDSN

現有 ODBC 檔案資料來源的名稱。

Language

SQL Server 語言名稱 (選擇性)。 SQL Server 可以將多種語言的訊息儲存在 sysmessages 中。 如果使用多種語言連接到 SQL Server,Language 會指定哪些訊息組合將用於連接。

MARS_Connection

啟用或停用連接上的 Multiple Active Result Sets (MARS)。 可辨識的值為 "yes" 和 "no"。 預設值是 "no"。

MultiSubnetFailover

在連接到 SQL Server 2012 可用性群組的可用性群組接聽程式或 SQL Server 2012 容錯移轉叢集執行個體時,永遠指定 multiSubnetFailover=Yes。 multiSubnetFailover=Yes 會設定 SQL Server Native Client 來提供目前使用中伺服器的更快速偵測與連接。 可能的值是 Yes 和 No。 例如:

MultiSubnetFailover=Yes

預設值為 No。 如需有關 SQL Server Native Client 中 AlwaysOn 可用性群組 支援的詳細資訊,請參閱<高可用性/災害復原的 SQL Server Native Client 支援>。

Net

"Network" 的同義字。

Network

有效值為 dbnmpntw (具名管道) 和 dbmssocn (TCP/IP)。

同時指定 Network 關鍵字的值,以及 Server 關鍵字的通訊協定前置詞,是錯誤的做法。

PWD

指定於 UID 參數中之 SQL Server 登入帳戶的密碼。 如果登入具有 NULL 密碼或正在使用 Windows 驗證 (Trusted_Connection = yes),就不需要指定 PWD。

QueryLog_On

當為 "yes" 時,連接上會啟用長時間執行之查詢資料的記錄。 當為 "no" 時,不會記錄長時間執行的查詢資料。

QueryLogFile

用來記錄長時間執行之查詢資料的檔案完整路徑或檔案名稱。

QueryLogTime

數字字元字串,可指定用來記錄長時間執行之查詢的臨界值 (以毫秒為單位)。 在指定的時間內未得到回應的任何查詢都會寫入長時間執行的查詢記錄檔中。

QuotedId

當為 "yes" 時,連接的 QUOTED_IDENTIFIERS 會設定為 ON,而且 SQL Server 會使用 ISO 規則,不論 SQL 陳述式中是否使用引號。 當設定為 no 時,連接的 QUOTED_IDENTIFIERS 會設定為 OFF, 然後 SQL Server 會遵循 Transact-SQL 傳統規則,不論 SQL 陳述式中是否使用引號。 如需詳細資訊,請參閱<ISO 選項的作用>。

Regional

當設定為 "yes" 時,SQL Server Native Client ODBC 驅動程式將貨幣、日期和時間資料轉換成字元資料時,會使用用戶端設定。 轉換僅限單向;此驅動程式無法辨識非 ODBC 標準格式的日期字串或貨幣值;例如,INSERT 或 UPDATE 陳述式中使用的參數。 當設定為 "no" 時,此驅動程式會使用 ODBC 標準字串來表示轉換成字元資料的貨幣、日期和時間資料。

SaveFile

如果連接成功,要用來儲存目前連接之屬性的 ODBC 資料來源檔案名稱。

Server

SQL Server 執行個體的名稱。 此值必須是網路上的伺服器名稱、IP 位址,或是 SQL Server 組態管理員別名的名稱。

Address 關鍵字會覆寫 Server 關鍵字。

您可藉由指定下列其中一個項目,連接到本機伺服器上的預設執行個體:

  • Server=;

  • Server=.;

  • Server=(local);

  • Server=(localhost);

  • Server=(localdb)\instancename;

如需有關 LocalDB 支援的詳細資訊,請參閱<SQL Server Native Client 對 LocalDB 的支援>。

若要指定 SQL Server 的具名執行個體,請附加 \InstanceName。

如果未指定伺服器,就會連接到本機電腦上的預設執行個體。

若您指定 IP 位址,請確定在 SQL Server 組態管理員中已啟用 TCP/IP 或具名管道通訊協定。

Server 關鍵字的完整語法如下:

Server=[protocol:]Server[,port]

protocol 可以是 tcp (TCP/IP)、lpc (共用記憶體) 或 np (具名管道)。

下列是指定具名管道的範例:

np:\\.\pipe\MSSQL$MYINST01\sql\query

此程式碼行指定具名管道通訊協定、本機電腦上的具名管道 (\\.\pipe)、SQL Server 執行個體的名稱 (MSSQL$MYINST01) 以及具名管道的預設名稱 (sql/query)。

如果沒有指定 protocol 或 Network 關鍵字,則 SQL Server Native Client 會使用在 SQL Server 組態管理員中指定的通訊協定順序。

port 是在指定的伺服器上所要連接的通訊埠。 根據預設,SQL Server 會使用通訊埠 1433。

當使用 SQL Server Native Client 時,會忽略在 ODBC 連接字串中傳遞給 Server 的值開頭的空格。

ServerSPN

伺服器的 SPN。 預設值為空字串。 空字串會讓 SQL Server Native Client 使用驅動程式產生的預設 SPN。

StatsLog_On

當設定為 "yes" 時,會啟用 SQL Server Native Client ODBC 驅動程式效能資料的擷取。 當設定為 "no" 時,連接上無法取得 SQL Server Native Client ODBC 驅動程式效能資料。

StatsLogFile

用來記錄 SQL Server Native Client ODBC 驅動程式效能統計資料之檔案的完整路徑和檔案名稱。

Trusted_Connection

當為 "yes" 時,會指示 SQL Server Native Client ODBC 驅動程式使用 Windows 驗證模式進行登入驗證。 否則會指示 SQL Server Native Client ODBC 驅動程式使用 SQL Server 使用者名稱和密碼進行登入驗證,而且必須指定 UID 和 PWD 密碼。

TrustServerCertificate

當搭配 Encrypt 使用時,會利用自行簽署的伺服器憑證啟用加密。

UID

有效的 SQL Server 登入帳戶。 使用 Windows 驗證時不需要指定 UID。

UseProcForPrepare

這個關鍵字已被取代,而且 SQL Server Native Client ODBC 驅動程式會忽略它的設定。

WSID

工作站識別碼。 一般而言,這是應用程式所在之電腦的網路名稱 (選擇性)。 如果指定的話,這個值就會儲存在 master.dbo.sysprocesses 資料行 hostname 中,而且會由 sp_whoHOST_NAME 函數所傳回。

[!附註]

地區轉換設定適用於貨幣、數值、日期和時間資料類型。 此轉換設定只適用於輸出轉換,而且只有當貨幣、數值、日期或時間值轉換為字元字串時,才能看到。

SQL Server Native Client ODBC 驅動程式會針對目前的使用者使用地區設定的登錄設定。 如果應用程式在連接後透過呼叫 SetThreadLocale 來設定目前執行緒的地區設定,驅動程式就不會接受它。

變更資料來源的地區行為可能會導致應用程式失敗。 剖析日期字串並預期日期字串如 ODBC 定義之方式顯示的應用程式,可能會受到變更此值的負面影響。

OLE DB 提供者連接字串關鍵字

OLE DB 應用程式有兩種方法可初始化資料來源物件:

  • IDBInitialize::Initialize

  • IDataInitialize::GetDataSource

在第一個案例中,提供者字串可用來初始化連接屬性,其方式是在 DBPROPSET_DBINIT 屬性集中設定 DBPROP_INIT_PROVIDERSTRING 屬性。 在第二個案例中,初始化字串可以傳遞給 IDataInitialize::GetDataSource 方法來初始化連接屬性。 這兩個方法都會初始化相同的 OLE DB 連接屬性,但是會使用不同的關鍵字集合。 IDataInitialize::GetDataSource 所使用的關鍵字集合最少是初始化屬性群組內的屬性描述。

如果任何提供者字串設定所包含的對應 OLE DB 屬性設定為預設值或明確設定為某個值,OLE DB 屬性值將在提供者字串中覆寫此設定。

在提供者字串中透過 DBPROP_INIT_PROVIDERSTRING 值所設定的布林屬性是使用 "yes" 和 "no" 的值所設定。 在初始化字串中使用 IDataInitialize::GetDataSource 所設定的布林屬性是使用 "true" 和 "false" 的值所設定。

使用 IDataInitialize::GetDataSource 的應用程式也可以使用 IDBInitialize::Initialize 所用的關鍵字,但是只適用於沒有預設值的屬性。 如果應用程式在初始化字串中同時使用 IDataInitialize::GetDataSource 關鍵字和 IDBInitialize::Initialize 關鍵字,則會使用 IDataInitialize::GetDataSource 關鍵字設定。 強烈建議您不要讓應用程式在 IDataInitialize:GetDataSource 連接字串中使用 IDBInitialize::Initialize 關鍵字,因為將來的版本可能無法維護這個行為。

[!附註]

透過 IDataInitialize::GetDataSource 傳遞的連接字串會經由 IDBProperties::SetProperties 轉換成屬性並加以套用。 如果元件服務在 IDBProperties::GetPropertyInfo 中找到屬性描述,此屬性將會當做獨立屬性來套用。 否則,它將會透過 DBPROP_PROVIDERSTRING 屬性來套用。 例如,如果您指定連接字串 Data Source=server1;Server=server2,Data Source 將會設定為屬性,但是 Server 將會進入提供者字串。

如果您指定相同提供者特有之屬性的多個執行個體,將會使用第一個屬性的值。

OLE DB 應用程式使用的連接字串如果搭配 IDBInitialize::Initialize 使用 DBPROP_INIT_PROVIDERSTRING,其語法如下:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[{]attribute-value[}]

attribute-value ::= character-string

attribute-keyword ::= identifier

可以選擇用大括號括住屬性值,這樣是很好的作法。 如此可在屬性值包含非英數字元時避免問題發生。 值中的第一個右大括號應該會結束該值,所以值不能包含右大括號字元。

連接字串關鍵字 = 符號後面的空格字元應該解譯為常值,即使該值括在引號內也是如此。

下表描述可搭配 DBPROP_INIT_PROVIDERSTRING 使用的關鍵字。

關鍵字

初始化屬性

說明

Addr

SSPROP_INIT_NETWORKADDRESS

"Address" 的同義字。

Address

SSPROP_INIT_NETWORKADDRESS

組織中 SQL Server 執行個體的網路位址。

如需有關有效位址語法的詳細資訊,請參閱本主題稍後對於 Address ODBC 關鍵字的說明。

APP

SSPROP_INIT_APPNAME

識別應用程式的字串。

ApplicationIntent

SSPROP_INIT_APPLICATIONINTENT

當連接到伺服器時,宣告應用程式工作負載類型。 可能的值是 ReadOnly 和 ReadWrite。

預設值為 ReadWrite。 如需有關 SQL Server Native Client 中 AlwaysOn 可用性群組 支援的詳細資訊,請參閱<高可用性/災害復原的 SQL Server Native Client 支援>。

AttachDBFileName

SSPROP_INIT_FILENAME

可附加資料庫的主要檔案名稱,包括完整路徑名稱。 若要使用 AttachDBFileName,您也必須使用提供者字串 Database 關鍵字來指定資料庫名稱。 如果之前已附加資料庫,SQL Server 不會重新附加它 (它會使用附加的資料庫當做連接的預設值)。

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

"AutoTranslate" 的同義字。

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

設定 OEM/ANSI 字元轉譯。 可辨識的值為 "yes" 和 "no"。

Database

DBPROP_INIT_CATALOG

資料庫名稱。

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

指定要使用的資料類型處理模式。 認得的值為 "0" (代表提供者資料類型) 和 "80" (代表 SQL Server 2000 資料類型)。

Encrypt

SSPROP_INIT_ENCRYPT

指定當透過網路傳送資料以前,是否應該先加密資料。 可能的值為 "yes" 和 "no"。 預設值為 "no"。

FailoverPartner

SSPROP_INIT_FAILOVERPARTNER

用於資料庫鏡像的容錯移轉伺服器名稱。

FailoverPartnerSPN

SSPROP_INIT_FAILOVERPARTNERSPN

容錯移轉夥伴的 SPN。 預設值為空字串。 空字串會讓 SQL Server Native Client 使用提供者產生的預設 SPN。

Language

SSPROPT_INIT_CURRENTLANGUAGE

SQL Server 語言。

MarsConn

SSPROP_INIT_MARSCONNECTION

當伺服器為 SQL Server 2005 或更新版本時,啟用或停用連接上的 Multiple Active Result Sets (MARS)。 可能的值為 "yes" 和 "no"。 預設值為 "no"。

Net

SSPROP_INIT_NETWORKLIBRARY

"Network" 的同義字。

Network

SSPROP_INIT_NETWORKLIBRARY

用來建立組織中 SQL Server 執行個體之連接的網路程式庫。

Network Library

SSPROP_INIT_NETWORKLIBRARY

"Network" 的同義字。

PacketSize

SSPROP_INIT_PACKETSIZE

網路封包大小。 預設值是 4096。

PersistSensitive

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

接受的值為 "yes" 和 "no" 字串。 當為 "no" 時,不允許使用資料來源物件來保存敏感性驗證資訊。

PWD

DBPROP_AUTH_PASSWORD

SQL Server 登入密碼。

Server

DBPROP_INIT_DATASOURCE

組織中 SQL Server 執行個體的名稱。

如果沒有指定,就會連接至本機電腦上的預設執行個體。

如需有關有效位址語法的詳細資訊,請參閱本主題中對於 Server ODBC 關鍵字的說明。

ServerSPN

SSPROP_INIT_SERVERSPN

伺服器的 SPN。 預設值為空字串。 空字串會讓 SQL Server Native Client 使用提供者產生的預設 SPN。

Timeout

DBPROP_INIT_TIMEOUT

等候資料來源初始化完成的時間量 (以秒為單位)。

Trusted_Connection

DBPROP_AUTH_INTEGRATED

當為 "yes" 時,會指示 SQL Server Native Client OLE DB 提供者使用 Windows 驗證模式進行登入驗證。 否則會指示 SQL Server Native Client OLE DB 提供者使用 SQL Server 使用者名稱和密碼進行登入驗證,而且必須指定 UID 和 PWD 密碼。

TrustServerCertificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

接受的值為 "yes" 和 "no" 字串。 預設值為 "no",這表示將會驗證伺服器憑證。

UID

DBPROP_AUTH_USERID

SQL Server 登入名稱。

UseProcForPrepare

SSPROP_INIT_USEPROCFORPREP

這個關鍵字已被取代,而且 SQL Server Native Client OLE DB 提供者會忽略它的設定。

WSID

SSPROP_INIT_WSID

工作站識別碼。

OLE DB 應用程式使用的連接字串如果使用 IDataInitialize::GetDataSource,其語法如下:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=[quote]attribute-value[quote]

attribute-value ::= character-string

attribute-keyword ::= identifier

quote ::= " | '

屬性的使用必須符合其範圍內所允許的語法。 例如,WSID 會使用大括號 ({}) 字元,而 Application Name 會使用單引號 (') 或雙引號 (") 字元。 只有字串屬性可以加上引號。 嘗試將整數或列舉屬性加上引號將會產生「連接字串沒有符合 OLE DB 規格」錯誤。

您可以選擇用單引號或雙引號括住屬性值,這樣是很好的作法。 如此可在值包含非英數字元時避免問題發生。 使用的引號字元也可出現在值當中,但前提必須是雙引號字元。

連接字串關鍵字 = 符號後面的空格字元應該解譯為常值,即使該值括在引號內也是如此。

如果連接字串具有下表所列的多個屬性,將會使用最後一個屬性的值。

下表描述可搭配 IDataInitialize::GetDataSource 使用的關鍵字:

關鍵字

初始化屬性

說明

Application Name

SSPROP_INIT_APPNAME

識別應用程式的字串。

Application Intent

SSPROP_INIT_APPLICATIONINTENT

當連接到伺服器時,宣告應用程式工作負載類型。 可能的值是 ReadOnly 和 ReadWrite。

預設值為 ReadWrite。 如需有關 SQL Server Native Client 中 AlwaysOn 可用性群組 支援的詳細資訊,請參閱<高可用性/災害復原的 SQL Server Native Client 支援>。

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

"AutoTranslate" 的同義字。

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

設定 OEM/ANSI 字元轉譯。 認得的值為 "true" 和 "false"。

Connect Timeout

DBPROP_INIT_TIMEOUT

等候資料來源初始化完成的時間量 (以秒為單位)。

Current Language

SSPROPT_INIT_CURRENTLANGUAGE

SQL Server 語言名稱。

Data Source

DBPROP_INIT_DATASOURCE

組織中 SQL Server 執行個體的名稱。

如果沒有指定,就會連接至本機電腦上的預設執行個體。

如需有關有效位址語法的詳細資訊,請參閱本主題稍後對於 Server ODBC 關鍵字的說明。

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

指定要使用的資料類型處理模式。 認得的值為 "0" (代表提供者資料類型) 和 "80" (代表 SQL Server 2000 資料類型)。

Failover Partner

SSPROP_INIT_FAILOVERPARTNER

用於資料庫鏡像的容錯移轉伺服器名稱。

Failover Partner SPN

SSPROP_INIT_FAILOVERPARTNERSPN

容錯移轉夥伴的 SPN。 預設值為空字串。 空字串會讓 SQL Server Native Client 使用提供者產生的預設 SPN。

Initial Catalog

DBPROP_INIT_CATALOG

資料庫名稱。

Initial File Name

SSPROP_INIT_FILENAME

可附加資料庫的主要檔案名稱,包括完整路徑名稱。 若要使用 AttachDBFileName,您也必須使用提供者字串 DATABASE 關鍵字來指定資料庫名稱。 如果之前已附加資料庫,SQL Server 不會重新附加它 (它會使用附加的資料庫當做連接的預設值)。

Integrated Security

DBPROP_AUTH_INTEGRATED

接受 "SSPI" 值進行 Windows 驗證。

MARS Connection

SSPROP_INIT_MARSCONNECTION

啟用或停用連接上的 Multiple Active Result Sets (MARS)。 認得的值為 "true" 和 "false"。 預設值為 "false"。

Network Address

SSPROP_INIT_NETWORKADDRESS

組織中 SQL Server 執行個體的網路位址。

如需有關有效位址語法的詳細資訊,請參閱本主題稍後對於 Address ODBC 關鍵字的說明。

Network Library

SSPROP_INIT_NETWORKLIBRARY

用來建立組織中 SQL Server 執行個體之連接的網路程式庫。

Packet Size

SSPROP_INIT_PACKETSIZE

網路封包大小。 預設值是 4096。

Password

DBPROP_AUTH_PASSWORD

SQL Server 登入密碼。

Persist Security Info

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

接受的值為 "true" 和 "false" 字串。 當為 "false" 時,不允許使用資料來源物件來保存敏感性驗證資訊。

Provider

 

如果是 SQL Server Native Client,這應該是 "SQLNCLI11"。

Server SPN

SSPROP_INIT_SERVERSPN

伺服器的 SPN。 預設值為空字串。 空字串會讓 SQL Server Native Client 使用提供者產生的預設 SPN。

Trust Server Certificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

接受的值為 "true" 和 "false" 字串。 預設值為 "false",這表示將會驗證伺服器憑證。

Use Encryption for Data

SSPROP_INIT_ENCRYPT

指定當透過網路傳送資料以前,是否應該先加密資料。 可能的值為 "true" 和 "false"。 預設值為 "false"。

User ID

DBPROP_AUTH_USERID

SQL Server 登入名稱。

Workstation ID

SSPROP_INIT_WSID

工作站識別碼。

注意:在此連接字串中,"Old Password" 屬性會設定 SSPROP_AUTH_OLD_PASSWORD,這是無法透過提供者字串屬性取得的目前密碼 (可能已過期)。

ActiveX Data Objects (ADO) 連接字串關鍵字

ADO 應用程式會設定 ADODBConnection 物件的 ConnectionString 屬性,或是提供連接字串當做 ADODBConnection 物件之 Open 方法的參數。

ADO 應用程式也可以使用 OLE DB IDBInitialize::Initialize 方法所使用的關鍵字,但是只適用於沒有預設值的屬性。 如果應用程式在初始化字串中同時使用 ADO 關鍵字和 IDBInitialize::Initialize 關鍵字,將會使用 ADO 關鍵字設定。 強烈建議您只讓應用程式使用 ADO 連接字串關鍵字。

ADO 使用的連接字串具有以下語法:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string

empty-string ::=

attribute ::= attribute-keyword=["]attribute-value["]

attribute-value ::= character-string

attribute-keyword ::= identifier

可以選擇用雙引號括住屬性值,這樣是很好的作法。 如此可在值包含非英數字元時避免問題發生。 屬性值不能包含雙引號。

下表描述可搭配 ADO 連接字串使用的關鍵字:

關鍵字

初始化屬性

說明

Application Intent

SSPROP_INIT_APPLICATIONINTENT

當連接到伺服器時,宣告應用程式工作負載類型。 可能的值是 ReadOnly 和 ReadWrite。

預設值為 ReadWrite。 如需有關 SQL Server Native Client 中 AlwaysOn 可用性群組 支援的詳細資訊,請參閱<高可用性/災害復原的 SQL Server Native Client 支援>。

Application Name

SSPROP_INIT_APPNAME

識別應用程式的字串。

Auto Translate

SSPROP_INIT_AUTOTRANSLATE

"AutoTranslate" 的同義字。

AutoTranslate

SSPROP_INIT_AUTOTRANSLATE

設定 OEM/ANSI 字元轉譯。 認得的值為 "true" 和 "false"。

Connect Timeout

DBPROP_INIT_TIMEOUT

等候資料來源初始化完成的時間量 (以秒為單位)。

Current Language

SSPROPT_INIT_CURRENTLANGUAGE

SQL Server 語言名稱。

Data Source

DBPROP_INIT_DATASOURCE

組織中 SQL Server 執行個體的名稱。

如果沒有指定,就會連接至本機電腦上的預設執行個體。

如需有關有效位址語法的詳細資訊,請參閱本主題中對於 Server ODBC 關鍵字的說明。

DataTypeCompatibility

SSPROP_INIT_DATATYPECOMPATIBILITY

指定即將使用之資料類型處理的模式。 認得的值為 "0" (代表提供者資料類型) 和 "80" (代表 SQL Server 2000 資料類型)。

Failover Partner

SSPROP_INIT_FAILOVERPARTNER

用於資料庫鏡像的容錯移轉伺服器名稱。

Failover Partner SPN

SSPROP_INIT_FAILOVERPARTNERSPN

容錯移轉夥伴的 SPN。 預設值為空字串。 空字串會讓 SQL Server Native Client 使用提供者產生的預設 SPN。

Initial Catalog

DBPROP_INIT_CATALOG

資料庫名稱。

Initial File Name

SSPROP_INIT_FILENAME

可附加資料庫的主要檔案名稱,包括完整路徑名稱。 若要使用 AttachDBFileName,您也必須使用提供者字串 DATABASE 關鍵字來指定資料庫名稱。 如果之前已附加資料庫,SQL Server 不會重新附加它 (它會使用附加的資料庫當做連接的預設值)。

Integrated Security

DBPROP_AUTH_INTEGRATED

接受 "SSPI" 值進行 Windows 驗證。

MARS Connection

SSPROP_INIT_MARSCONNECTION

當伺服器為 SQL Server 2005 或更新版本時,啟用或停用連接上的 Multiple Active Result Sets (MARS)。 認得的值為 "true" 和 "false"。預設值是 "false"。

Network Address

SSPROP_INIT_NETWORKADDRESS

組織中 SQL Server 執行個體的網路位址。

如需有關有效位址語法的詳細資訊,請參閱本主題中對於 Address ODBC 關鍵字的說明。

Network Library

SSPROP_INIT_NETWORKLIBRARY

用來建立組織中 SQL Server 執行個體之連接的網路程式庫。

Packet Size

SSPROP_INIT_PACKETSIZE

網路封包大小。 預設值是 4096。

Password

DBPROP_AUTH_PASSWORD

SQL Server 登入密碼。

Persist Security Info

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

接受的值為 "true" 和 "false" 字串。 如果為 "false",表示不允許資料來源物件保存機密的驗證資訊。

Provider

 

如果是 SQL Server Native Client,這應該是 "SQLNCLI11"。

Server SPN

SSPROP_INIT_SERVERSPN

伺服器的 SPN。 預設值為空字串。 空字串會讓 SQL Server Native Client 使用提供者產生的預設 SPN。

Trust Server Certificate

SSPROP_INIT_TRUST_SERVER_CERTIFICATE

接受的值為 "true" 和 "false" 字串。 預設值為 "false",這表示將會驗證伺服器憑證。

Use Encryption for Data

SSPROP_INIT_ENCRYPT

指定當透過網路傳送資料以前,是否應該先加密資料。 可能的值為 "true" 和 "false"。 預設值為 "false"。

User ID

DBPROP_AUTH_USERID

SQL Server 登入名稱。

Workstation ID

SSPROP_INIT_WSID

工作站識別碼。

注意:在此連接字串中,"Old Password" 屬性會設定 SSPROP_AUTH_OLD_PASSWORD,這是無法透過提供者字串屬性取得的目前密碼 (可能已過期)。

請參閱

其他資源

使用 SQL Server Native Client 建立應用程式