SQLBrowseConnect
适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)
SQLBrowse连接使用可分为三个连接信息的关键字 (keyword)。 对于每个关键字,下表指示是否返回有效值列表以及该关键字是否可选。
1 级
关键字 | 是否返回列表? | 是否可选? | 说明 |
---|---|---|---|
DSN | 空值 | 否 | SQLDataSources 返回 的数据源的名称。 如果使用 DRIVER 关键字,则无法使用 DSN 关键字。 |
DRIVER | 空值 | 否 | SQL Server Native Client ODBC 驱动程序名称为 {SQL Server Native Client 11}。 如果使用 DSN 关键字,则无法使用 DRIVER 关键字。 |
2 级
关键字 | 是否返回列表? | 是否可选? | 说明 |
---|---|---|---|
SERVER | 是 | 否 | 数据源所驻留网络上的服务器名称。 术语“(local)”可以输入为服务器,在这种情况下,可以使用 SQL Server 的本地副本,即使这是非网络版本也是如此。 |
UID | 否 | 是 | 用户登录 ID。 |
PWD | 否 | 是(取决于用户) | 用户指定的密码。 |
APP | 否 | 是 | 调用 SQLBrowse 的应用程序的名称连接。 |
WSID | 否 | 是 | 工作站 ID。 通常,这是运行应用程序的计算机的网络名称。 |
级别 3
关键字 | 是否返回列表? | 是否可选? | 说明 |
---|---|---|---|
DATABASE | 是 | 是 | SQL Server 数据库的名称。 |
LANGUAGE | 是 | 是 | SQL Server 使用的国家/地区语言。 |
SQLBrowse连接忽略存储在 ODBC 数据源定义中的 DATABA标准版 和 LANGUAGE 关键字 (keyword) 的值。 如果传递给 SQLBrowse 的连接字符串中指定的数据库或语言无效连接,则 SQLBrowse连接返回SQL_N企业版D_DATA和级别 3 连接属性。
以下属性通过调用 SQLSet连接Attr 设置,确定 SQLBrowse 返回的结果集连接。
Attribute | 说明 |
---|---|
SQL_COPT_SS_BROWSE_CONNECT | 如果它设置为 SQL_MORE_INFO_YES,SQLBrowse连接将返回一个扩展的服务器属性字符串。 下面是 SQLBrowse 返回的扩展字符串的示例连接: ServerName\InstanceName;Clustered:No;Version:8.00.131 在此字符串中,分号用于分隔与服务器有关的各部分信息, 逗号用于分隔不同的服务器实例。 |
SQL_COPT_SS_BROWSE_SERVER | 如果指定了服务器名称,SQLBrowse连接将返回指定服务器的信息。 如果 SQL_COPT_SS_BROW标准版_标准版RVER 设置为 NULL,SQLBrowse连接将返回域中所有服务器的信息。 请注意,由于网络问题,SQLBrowse连接可能不会收到来自所有服务器的及时响应。 因此,每个请求所返回的服务器列表都可能不同。 |
SQL_COPT_SS_BROWSE_CACHE_DATA | 如果 SQL_COPT_SS_BROWSE_CACHE_DATA 属性设置为 SQL_CACHE_DATA_YES,当缓冲区长度不足以容纳结果时,您可以提取块区中的数据。 此长度在 BUFFERLength 参数中指定为 SQLBrowse连接。 当有更多的数据可用时,将返回 SQL_NEED_DATA。 如果检索不到更多的数据,将返回 SQL_SUCCESS。 默认值是 SQL_CACHE_DATA_NO。 |
对高可用性、灾难恢复的 SQLBrowseConnect 支持
有关使用 SQLBrowse连接连接到 AlwaysOn 可用性组群集的详细信息,请参阅 SQL Server Native Client Support for High Availability, Disaster Recovery。
对服务主体名称 (SPN) 的 SQLBrowseConnect 支持
打开连接后,SQL Server Native Client 将SQL_COPT_SS_MUTUALLY_AUTHENTICATED并SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD用于打开连接的身份验证方法。
有关 SPN 的详细信息,请参阅客户端连接ions (ODBC)中的服务主体名称(SPN)。
更改历史记录
更新的内容 |
---|
介绍了 SQL_COPT_SS_BROWSE_CACHE_DATA。 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈