将连接字符串关键字用于 SQL Server 本机客户端
适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)
重要
SQL Server Native Client (SNAC) 未随附：
- SQL Server 2022 (16.x) 及更高版本
- SQL Server Management Studio 19 及更高版本
不建议在新应用开发中使用 SQL Server Native Client（SQLNCLI 或 SQLNCLI11）和旧版 Microsoft OLE DB Provider for SQL Server (SQLOLEDB)。
对于新项目，请使用以下驱动程序之一：
对于作为 SQL Server 数据库引擎组件（版本 2012 到 2019）随附的 SQLNCLI，请参阅此支持生命周期特例。
某些 SQL Server Native Client API 使用连接字符串来指定连接属性。 连接字符串是关键字和关联的值的列表；每个关键字标识特定的连接属性。
有关信息，请参阅 将连接字符串关键字与 OLE DB Driver for SQL Server 配合使用。
注意
SQL Server Native Client 允许在连接字符串中存在歧义性以保持向后兼容性（例如，某些关键字可以多次指定，并且可能会允许冲突关键字与基于位置或优先级的解决方法一起发生冲突）。 修改应用程序以使用 SQL Server Native Client 消除对连接字符串歧义的任何依赖关系时，这是一个很好的做法。
以下部分介绍在将 SQL Server Native Client 用作数据提供程序时可与 SQL Server Native Client OLE DB 访问接口、SQL Server Native Client ODBC 驱动程序和 ActiveX 数据对象（ADO）一起使用的关键字。
ODBC 驱动程序连接字符串关键字
ODBC 应用程序使用 连接字符串 作为 SQLDriverConnect 和 SQLBrowseConnect 函数的参数。
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 或 named pipes 协议。 使用 SQL Server Native Client 时，Address 的值优先于在 ODBC 连接字符串中传递给服务器的值。 另外请注意， Address=; 将连接到在 Server 关键字中指定的服务器，而 Address= ;, Address=.;、 Address=localhost; 和 Address=(local); 都会产生本地服务器的连接 。Address 关键字的完整语法如下所示 ： [protocol:]Address[,port |\pipe\pipename] protocol 可以是 tcp (TCP/IP)、 lpc （共享内存）或 np （命名管道）。 有关协议的详细信息，请参阅配置客户端协议。 如果未指定协议或网络关键字，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_who 和 APP_NAME 函数返回。 |
| ApplicationIntent | 连接到服务器时声明应用程序工作负荷类型。 可能的值为 ReadOnly 和 ReadWrite 。 默认值为 ReadWrite。 例如：ApplicationIntent=ReadOnly有关 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_C_CHAR发送到 SQL Server char、 varchar 或 文本 变量、参数或列的数据使用客户端 ANSI 代码页（ACP）从字符转换为 Unicode，然后使用服务器的 ACP 从 Unicode 转换为字符。 SQL Server char、 varchar 或 发送到客户端的文本 数据SQL_C_CHAR变量使用服务器 ACP 从字符转换为 Unicode，然后使用客户端 ACP 从 Unicode 转换为字符。 这些转换由 SQL Server Native Client ODBC 驱动程序在客户端上执行。 这要求在服务器上使用的相同 ANSI 代码页 (ACP) 在客户端上可用。 这些设置对于为下面这些传输而发生的转换无效： * Unicode SQL_C_WCHAR发送到 服务器上的 char、 varchar 或 文本 的客户端数据。 * char、 varchar 或 文本 服务器数据发送到客户端上的 Unicode SQL_C_WCHAR 变量。 * ANSI SQL_C_CHAR发送到服务器上的 Unicode nchar、 nvarchar 或 ntext 的客户端数据。 * 发送到客户端上的 ANSI SQL_C_CHAR 变量的 Unicode nchar、nvarchar 或 ntext 服务器数据。 如果是“no”，则不执行字符转换。 SQL Server Native Client ODBC 驱动程序不会转换发送到服务器上的 char、varchar 或文本变量、参数或列的客户端 ANSI 字符SQL_C_CHAR数据。 不会对 从服务器发送到客户端上的SQL_C_CHAR变量的 char、 varchar 或 文本 数据执行任何转换。 如果客户端和 SQL Server 使用不同的 ARP，则扩展字符可能会被误解。 |
| Database | 连接的默认 SQL Server 数据库的名称。 如果未 指定 Database ，则使用为登录名定义的默认数据库。 来自 ODBC 数据源的默认数据库将覆盖为登录定义的默认数据库。 除非还指定了 AttachDBFileName，否则数据库必须是现有数据库。 如果还指定了 AttachDBFileName，则它指向的主文件将附加并指定数据库指定的数据库名称。 |
| Driver | SQLDrivers 返回的驱动程序的名称。 SQL Server Native Client ODBC 驱动程序的关键字值为“{SQL Server Native Client 11.0}”。 如果指定了 Driver，并且 DriverCompletion 设置为SQL_DRIVER_NOPROMPT，则需要服务器关键字。 有关驱动程序名称的详细信息，请参阅 使用 SQL Server Native Client 标头和库文件。 |
| DSN | 现有 ODBC 用户或系统数据源的名称。 此关键字将替代可能在服务器、网络和 Address 关键字中指定的任何值。 |
| 加密 | 指定在通过网络发送数据之前是否应当将其加密。 可能的值为“yes”/“mandatory”（18.0+）、“no”/“optional”（18.0+）和“strict”（18.0+）。 版本 18.0+ 中的默认值为“yes”，在以前的版本中为“否”。 |
| 备用 | 此关键字已弃用，SQL Server Native Client ODBC 驱动程序将忽略其设置。 |
| Failover_Partner | 不能与主服务器建立连接时要使用的故障转移伙伴服务器的名称。 |
| FailoverPartnerSPN | 故障转移伙伴的 SPN。 默认值为空字符串。 空字符串导致 SQL Server Native Client 使用默认的驱动程序生成的 SPN。 |
| FileDSN | 现有 ODBC 文件数据源的名称。 |
| 语言 | SQL Server 语言名称（可选）。 SQL Server 可以在 sysmessages 中存储多种语言的消息。 如果使用多种语言连接到 SQL Server， 则 Language 指定用于连接的消息集。 |
| MARS_Connection | 启用或禁用连接上的多个活动结果集 (MARS)。 可识别的值为“yes”和“no”。 默认值为“no”。 |
| MultiSubnetFailover | 连接到 SQL Server 可用性组或 SQL Server 故障转移群集实例的可用性组侦听器时，始终指定 multiSubnetFailover=Yes 。 multiSubnetFailover=Yes 将 SQL Server Native Client 配置为更快地检测和连接到活动服务器（当前） 活动服务器。 可能的值为“是”和“否”。 默认值为 No。 例如：MultiSubnetFailover=Yes有关 SQL Server Native Client 对 AlwaysOn 可用性组的支持的详细信息，请参阅 SQL Server Native Client 对高可用性、灾难恢复的支持。 |
| Net | “Network”的同义词。 |
| Network | 有效值为 dbnmpntw （命名管道）和 dbmssocn （TCP/IP）。 为“网络”关键字和服务器关键字上的协议前缀指定值是错误的。 |
| PWD | UID 参数中指定的 SQL Server 登录帐户的密码。 如果登录名具有 NULL 密码或使用 Windows 身份验证（Trusted_Connection = yes），则不需要指定 PWD。 |
| QueryLog_On | 如果是“yes”，则在连接上启用对长时间运行的查询数据的日志记录。 如果是“no”，则不记录长时间运行的查询数据。 |
| QueryLogFile | 文件的完整路径和文件名，该文件用于记录长时间运行的查询上的数据。 |
| QueryLogTime | 数字字符串，指定记录长时间运行的查询的阈值（毫秒）。 未在指定时间内获得响应的任何查询将写入长时间运行查询日志文件。 |
| QuotedId | 如果为“是”，QUOTED_IDENTIFIER设置为 ON 连接，SQL Server 将使用有关在 SQL 语句中使用引号的 ISO 规则。 当否时，将为连接设置 off QUOTED_IDENTIFIER。 然后，SQL Server 遵循有关在 SQL 语句中使用引号的旧 Transact-SQL 规则。 有关详细信息，请参阅 ISO 选项的效果。 |
| Regional | 当“是”时，SQL Server Native Client ODBC 驱动程序在将货币、日期和时间数据转换为字符数据时使用客户端设置。 该转换是单向的；驱动程序不会识别其中非 ODBC 标准格式的日期字符串或货币值；例如，在 INSERT 或 UPDATE 语句中使用的参数。 如果是“no”，则驱动程序使用 ODBC 标准字符串来表示转换为字符数据的货币、日期和时间数据。 |
| SaveFile | 如果连接成功则在其中保存当前连接的属性的 ODBC 数据源文件的名称。 |
| 服务器 | SQL Server 实例的名称。 该值必须是服务器的网络名称、IP 地址或者 SQL Server 配置管理器别名。 “Address” 关键字将替代“Server” 关键字。 通过指定以下条件之一，可连接到本地服务器的默认实例： Server=; Server=.; Server=(local); Server=(local); Server=(localhost); Server=（localdb）\ instancename ; 有关 LocalDB 支持的详细信息，请参阅 SQL Server Native Client Support for LocalDB。 若要指定的命名的实例SQL Server，将追加 \InstanceName。 如果不指定服务器，则与本地计算机上的默认实例建立连接。 如果指定了 IP 地址，请确保在 SQL Server 配置管理器中启用了 TCP/IP 或 named pipes 协议。 Server 关键字的完整语法如下： Server= [protocol: ]Server[ ,port] protocol 可以是 tcp (TCP/IP)、 lpc （共享内存）或 np （命名管道）。 以下示例将指定一个命名管道： np:\\.\pipe\MSSQL$MYINST01\sql\query此行指定命名管道协议、本地计算机上的命名管道（ \\.\pipe）、SQL Server 实例的名称（MSSQL$MYINST01）和命名管道的默认名称（sql/query）。如果未指定协议或网络关键字，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 | 如果为“是”，则启用 SQL Server Native Client ODBC 驱动程序性能数据的捕获。 如果为“否”，SQL Server Native Client ODBC 驱动程序性能数据在连接上不可用。 |
| StatsLogFile | 用于记录 SQL Server Native Client ODBC 驱动程序性能统计信息的文件的完整路径和文件名。 |
| Trusted_Connection | 如果为“是”，则指示 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 | 工作站 ID。 通常，这是应用程序驻留于其上的计算机的网络名称（可选）。 如果指定，则此值存储在 master.dbo.sysprocesses 列主机名中，并由 sp_who 和 HOST_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”，则“数据源”将被设置为属性，但“Server”将进入提供程序字符串。
如果指定访问接口特定的属性相同的多个实例，则使用第一个属性的第一个值。
将 IDBInitialize::Initialize 和 DBPROP_INIT_PROVIDERSTRING 配合使用的 OLE DB 应用程序所使用的连接字符串具有以下语法 ：
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 不会重新附加它（它使用附加的数据库作为连接的默认数据库）。 |
| 自动翻译 | SSPROP_INIT_AUTOTRANSLATE | “AutoTranslate”的同义词。 |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | 配置 OEM/ANSI 字符转换。 可识别的值为“yes”和“no”。 |
| Database | DBPROP_INIT_CATALOG | 数据库名称。 |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | 指定要使用的数据类型的处理模式。 对于访问接口数据类型，可识别的值为“0”，对于 SQL Server 2000 数据类型则为“80”。 |
| 加密 | SSPROP_INIT_ENCRYPT | 指定在通过网络发送数据之前是否应当将其加密。 可能的值为“yes”和“no”。 默认值为“no”。 |
| FailoverPartner | SSPROP_INIT_FAILOVERPARTNER | 用于数据库镜像的故障转移服务器的名称。 |
| FailoverPartnerSPN | SSPROP_INIT_FAILOVERPARTNERSPN | 故障转移伙伴的 SPN。 默认值为空字符串。 空字符串导致 SQL Server Native Client 使用默认的提供程序生成的 SPN。 |
| 语言 | SSPROP_INIT_CURRENTLANGUAGE | SQL Server 语言。 |
| MarsConn | SSPROP_INIT_MARSCONNECTION | 如果服务器是 SQL Server 2005 (9.x) 或更高版本，则启用或禁用连接上的多个活动结果集 (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。 |
| 超时 | DBPROP_INIT_TIMEOUT | 等待数据源初始化完成的时间（秒）。 |
| Trusted_Connection | DBPROP_AUTH_INTEGRATED | 如果为“是”，则指示 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 | 工作站标识符。 |
使用 IDataInitialize::GetDataSource 的 OLE DB 应用程序所使用的连接字符串有以下语法 ：
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 使用大括号 ({}) 引号字符，而应用程序名称使用单引号字符 (') 或双引号字符 (")。 只有字符串属性可以加引号。 尝试将整数或枚举属性用引号引起来将导致“连接字符串不符合 OLE DB 规范”错误。
属性值可以选择放在单引号或双引号内，并且最好这样做。 这样可以避免当值包含非字母数字字符时出现问题。 也可以在值内使用引号字符，只要使用的是双引号。
连接字符串关键字的等号 (=) 之后的空白字符将被解释为文本，即使该值在引号内也是如此。
如果某一连接字符串具有下表所列的多个属性，将使用最后一个属性的值。
下表对可能与 IDataInitialize::GetDataSource 配合使用的关键字进行了说明 ：
| 关键字 | 初始化属性 | 说明 |
|---|---|---|
| 应用程序名称 | SSPROP_INIT_APPNAME | 用于标识应用程序的字符串。 |
| Application Intent | SSPROP_INIT_APPLICATIONINTENT | “ApplicationIntent”的同义词。 |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | 连接到服务器时声明应用程序工作负荷类型。 可能的值为 ReadOnly 和 ReadWrite 。 默认值为 ReadWrite。 有关 SQL Server Native Client 对 AlwaysOn 可用性组的支持的详细信息，请参阅 SQL Server Native Client 对高可用性、灾难恢复的支持。 |
| 自动翻译 | SSPROP_INIT_AUTOTRANSLATE | “AutoTranslate”的同义词。 |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | 配置 OEM/ANSI 字符转换。 可识别的值为“true”和“false”。 |
| Connect Timeout | DBPROP_INIT_TIMEOUT | 等待数据源初始化完成的时间（秒）。 |
| Current Language | SSPROP_INIT_CURRENTLANGUAGE | SQL Server 语言名称。 |
| 数据源 | DBPROP_INIT_DATASOURCE | 组织中的 SQL Server 实例的名称。 如果不指定，则与本地计算机上的默认实例建立连接。 有关有效地址语法的详细信息，请参阅本主题后面的 Server ODBC 关键字的说明。 |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | 指定要使用的数据类型的处理模式。 已识别的值是提供程序数据类型的“0”，对于 SQL Server 2000 （8.x） 数据类型，为“80”。 |
| Failover Partner | SSPROP_INIT_FAILOVERPARTNER | 用于数据库镜像的故障转移服务器的名称。 |
| Failover Partner SPN | SSPROP_INIT_FAILOVERPARTNERSPN | 故障转移伙伴的 SPN。 默认值为空字符串。 空字符串导致 SQL Server Native Client 使用默认的提供程序生成的 SPN。 |
| 初始目录 | DBPROP_INIT_CATALOG | 数据库名称。 |
| 初始文件名 | SSPROP_INIT_FILENAME | 可附加数据库的主文件的名称（包括完整路径名）。 若要使用 AttachDBFileName，还必须使用访问接口字符串 DATABASE 关键字来指定数据库名称 。 如果数据库以前附加过，SQL Server 不会重新附加它（它使用附加的数据库作为连接的默认数据库）。 |
| Integrated Security | DBPROP_AUTH_INTEGRATED | 接受 Windows 身份验证的值“SSPI”。 |
| MARS Connection | SSPROP_INIT_MARSCONNECTION | 启用或禁用连接上的多个活动结果集 (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。 |
| 密码 | DBPROP_AUTH_PASSWORD | SQL Server 登录密码。 |
| Persist Security Info | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | 接受字符串“true”和“false”作为值。 如果是“false”，则不允许数据源对象保留敏感的身份验证信息 |
| 提供程序 | 对于 SQL Server Native Client，这应为“SQLNCLI11”。 | |
| Server SPN | SSPROP_INIT_SERVERSPN | 服务器的 SPN。 默认值为空字符串。 空字符串导致 SQL Server Native Client 使用默认的提供程序生成的 SPN。 |
| 信任服务器证书 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | 接受字符串“true”和“false”作为值。 默认值为“false”，它意味着将验证服务器证书。 |
| Use Encryption for Data | SSPROP_INIT_ENCRYPT | 指定在通过网络发送数据之前是否应当将其加密。 可能的值为“true”和“false”。 默认值为 false。 |
| 用户 ID | DBPROP_AUTH_USERID | SQL Server 登录名。 |
| Workstation ID | SSPROP_INIT_WSID | 工作站标识符。 |
注意：在连接字符串中，“旧密码”属性会设置 SSPROP_AUTH_OLD_PASSWORD，它是当前密码（可能已过期），通过访问接口字符串属性无法获取该密码。
ActiveX 数据对象 (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 | “ApplicationIntent”的同义词。 |
| ApplicationIntent | SSPROP_INIT_APPLICATIONINTENT | 连接到服务器时声明应用程序工作负荷类型。 可能的值为 ReadOnly 和 ReadWrite 。 默认值为 ReadWrite。 有关 SQL Server Native Client 对 AlwaysOn 可用性组的支持的详细信息，请参阅 SQL Server Native Client 对高可用性、灾难恢复的支持。 |
| 应用程序名称 | SSPROP_INIT_APPNAME | 用于标识应用程序的字符串。 |
| 自动翻译 | SSPROP_INIT_AUTOTRANSLATE | “AutoTranslate”的同义词。 |
| AutoTranslate | SSPROP_INIT_AUTOTRANSLATE | 配置 OEM/ANSI 字符转换。 可识别的值为“true”和“false”。 |
| Connect Timeout | DBPROP_INIT_TIMEOUT | 等待数据源初始化完成的时间（秒）。 |
| Current Language | SSPROP_INIT_CURRENTLANGUAGE | SQL Server 语言名称。 |
| 数据源 | DBPROP_INIT_DATASOURCE | 组织中的 SQL Server 实例的名称。 如果不指定，则与本地计算机上的默认实例建立连接。 有关有效地址语法的详细信息，请参阅本主题中的 Server ODBC 关键字的说明。 |
| DataTypeCompatibility | SSPROP_INIT_DATATYPECOMPATIBILITY | 指定将使用的数据类型的处理模式。 对于访问接口数据类型，可识别的值为“0”，对于 SQL Server 2000 数据类型则为“80”。 |
| Failover Partner | SSPROP_INIT_FAILOVERPARTNER | 用于数据库镜像的故障转移服务器的名称。 |
| Failover Partner SPN | SSPROP_INIT_FAILOVERPARTNERSPN | 故障转移伙伴的 SPN。 默认值为空字符串。 空字符串导致 SQL Server Native Client 使用默认的提供程序生成的 SPN。 |
| 初始目录 | DBPROP_INIT_CATALOG | 数据库名称。 |
| 初始文件名 | SSPROP_INIT_FILENAME | 可附加数据库的主文件的名称（包括完整路径名）。 若要使用 AttachDBFileName，还必须使用访问接口字符串 DATABASE 关键字来指定数据库名称 。 如果数据库以前附加过，SQL Server 不会重新附加它（它使用附加的数据库作为连接的默认数据库）。 |
| Integrated Security | DBPROP_AUTH_INTEGRATED | 接受 Windows 身份验证的值“SSPI”。 |
| MARS Connection | SSPROP_INIT_MARSCONNECTION | 如果服务器是 SQL Server 2005 (9.x) 或更高版本，则启用或禁用连接上的多个活动结果集 (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。 |
| 密码 | DBPROP_AUTH_PASSWORD | SQL Server 登录密码。 |
| Persist Security Info | DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | 接受字符串“true”和“false”作为值。 如果是“false”，则不允许数据源对象保留敏感的身份验证信息。 |
| 提供程序 | 对于 SQL Server Native Client，这应为“SQLNCLI11”。 | |
| Server SPN | SSPROP_INIT_SERVERSPN | 服务器的 SPN。 默认值为空字符串。 空字符串导致 SQL Server Native Client 使用默认的提供程序生成的 SPN。 |
| 信任服务器证书 | SSPROP_INIT_TRUST_SERVER_CERTIFICATE | 接受字符串“true”和“false”作为值。 默认值为“false”，它意味着将验证服务器证书。 |
| Use Encryption for Data | SSPROP_INIT_ENCRYPT | 指定在通过网络发送数据之前是否应当将其加密。 可能的值为“true”和“false”。 默认值为 false。 |
| 用户 ID | DBPROP_AUTH_USERID | SQL Server 登录名。 |
| Workstation ID | SSPROP_INIT_WSID | 工作站标识符。 |
注意
在连接字符串中，“旧密码”属性会设置 SSPROP_AUTH_OLD_PASSWORD，它是当前（有可能是过期的）密码，通过提供程序字符串属性无法得到该密码。