将连接字符串关键字用于 SQL Server Native Client

时　间:2019-09-05 20:19:02
作　者:易勋   ID：35404  城市：上海
摘　要:某些 SQL Server Native Client API 使用连接字符串来指定连接属性。 连接字符串是关键字和关联的值的列表；每个关键字标识特定的连接属性。
正　文:

下面几节描述了可以在使用 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 连接字符串一起使用的关键字进行了说明。

注意：区域转换设置应用于货币、数字、日期和时间数据类型。 转换设置仅应用于输出转换，并仅在货币、数字、日期或时间值转换为字符串时可见。

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 关键字，因为在未来的版本中可能不保留该行为 。

如果指定访问接口特定的属性相同的多个实例，则使用第一个属性的第一个值。

将 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 一起使用的关键字进行了说明。

使用 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_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 连接字符串一起使用的关键字进行了说明：

注意：在连接字符串中，“旧密码”属性会设置 SSPROP_AUTH_OLD_PASSWORD，它是当前密码（可能已过期），通过访问接口字符串属性无法获取该密码。