创建SQL Server URI

用于连接 URI SQL Server Microsoft BizTalk 适配器包含适配器用来建立与 SQL Server 连接的属性。 本主题提供有关 SQL Server URI 的信息,并提供指向其他主题的链接,这些主题说明如何在不同编程方案中指定 URI。

SQL 适配器的连接 URI

WCF 中的典型终结点地址 URI 表示为: scheme://hostinfoparams?query_string,其中:

  • scheme 是方案名称。

  • hostinfoparams 是建立与主机的连接所需的信息;例如,服务器名称。

  • query_string是由问号分隔的参数的可选名称/值集合 (?) 。

    适配器SQL URI 遵循此基本格式,实现方式如下:

  
mssql://[Server_Name[:Portno]]/[Database_Instance_Name]/[Database_Name]?FailoverPartner=[Partner_Server_Name]&InboundId=[Inbound_ID]  

其中, mssql 是连接 URI SQL Server方案。

下表说明了连接 URI 中包含的属性。

连接 URI 属性 类别 说明
[SERVER_NAME] hostinfoparams 安装服务器名称SQL Server服务器的名称。 如果不指定值,适配器将服务器名称假定为"localhost",并在本地服务器上SQL Server数据库建立连接。
[PORTNO] hostinfoparams 建立连接的端口号。 如果未指定值,适配器会通过默认端口进行连接。
[DATABASE_INSTANCE_NAME] hostinfoparams 要连接到SQL Server实例的名称。 如果未指定值,适配器将连接到默认数据库实例。
[DATABASE_NAME] hostinfoparams 要连接到的数据库的名称。 如果未指定值,适配器将连接到默认数据库。
[PARTNER_SERVER_NAME] query_string 如果主数据库SQL Server数据库不可用,则SQL Server数据库的名称。 有关数据库镜像的高可用性SQL Server,请参阅数据库镜像SQL Server
[INBOUND_ID] query_string 添加到连接 URI 以使其唯一的标识符。 如果要为 TypedPolling 入站操作生成元数据,则必须提供此连接参数。 此外,在 BizTalk 应用程序中,如果有多个接收位置轮询同一数据库,则入站 ID 会使连接 URI 是唯一的,从而使适配器客户端能够接收来自不同接收位置的同一数据库的轮询消息。 有关详细信息,请参阅使用 BizTalk Server 从多个接收端口接收来自SQL轮询BizTalk Server

注意

有关这些连接字符串属性详细信息,请参阅 SqlConnection.ConnectionString 属性

SQL Server凭据和连接 URI

SQL适配器不支持在连接 URI 中指定凭据。 有关在应用程序(使用 SQL 适配器)中指定凭据SQL

在连接 URI 中使用特殊字符

SQL适配器不支持指定具有任何参数值的特殊字符的连接 URI。 如果连接参数值包含特殊字符,请确保执行以下操作之一:

  • 如果使用"添加适配器服务引用插件"或"使用适配器服务外接程序"在 Visual Studio 中指定 URI,则必须在"URI 属性"选项卡中按现有方式指定 URI,即,无需使用任何转义字符。 如果直接在"配置 URI"字段中指定 URI ,并且连接参数包含特殊字符,则必须使用正确的转义字符指定连接参数。

    例如,如果连接 URI 具有一个名称为 sql server的参数,则必须将它指定为 sql%20server

  • 如果在 BizTalk Server 管理控制台中创建发送或接收端口时指定 URI,并且连接参数包含特殊字符,则必须使用正确的转义字符指定连接参数。

使用连接 URI 连接数据库SQL Server数据库

下面是该适配器的示例连接 URI SQL URI。

mssql://sql_server/sql_server_instance//  

在上一示例中,"sql_server"是安装 SQL Server 的计算机的名称,而"sql_server_instance"是要连接到的数据库实例的名称。 由于未指定数据库名称,因此适配器将连接到默认数据库。

下面是连接 URI 的示例,其中 SQL Server 数据库安装在与 SQL 适配器相同的计算机上。 此示例中,适配器连接到本地计算机上my_database"sql_server_instance"数据库实例的数据库"实例"。

mssql://localhost/sql_server_instance/my_database/  

此示例中,适配器连接到本地计算机上运行的默认实例的默认数据库。

mssql://localhost///  

若要了解如何指定与 SQL Server 数据库的连接,请参阅:

  • 使用"使用适配器服务 BizTalk Project 外接程序"或"添加适配器服务引用 Visual Studio 插件",请参阅 连接 SQL Server Visual Studio SQL 适配器

  • 在 BizTalk Server 解决方案中 (位置配置) 端口或接收端口,请参阅手动配置到 SQL 适配器的物理端口绑定

  • 在编程解决方案中使用 WCF 通道模型,请参阅使用 SQL 创建通道

  • 在编程解决方案中使用 WCF 服务模型,请参阅为 SQL 适配器配置客户端绑定

另请参阅

开发 SQL 应用程序