共用方式為


建立 SQL Server 連線 URI

Microsoft BizTalk Adapter for SQL Server 連線 URI 包含配接器用來建立 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 是 SQL Server 連線 URI 的配置。

下表說明連線 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 應用程式中,如果您有多個接收位置輪詢相同的資料庫,輸入標識碼會讓連線 URI 是唯一的,藉此讓配接器用戶端在不同的接收位置上接收來自相同資料庫的輪詢訊息。 如需詳細資訊,請參閱 使用 BizTalk Server 從 SQL 接收多個接收埠的輪詢訊息

備註

如需這些連接字串屬性的詳細資訊,請參閱 SqlConnection.ConnectionString 屬性

SQL Server 認證和連線 URI

SQL 配接器不支援在連線 URI 中指定認證。 如需在使用 SQL 配接器之應用程式中指定認證的詳細資訊,請參閱 保護 SQL 應用程式

在連線 URI 中使用特殊字元

SQL 配接器不支援指定任何參數值具有特殊字元的連接 URI。 如果連接參數值包含特殊字元,請確定您執行下列其中一項:

  • 如果您使用 [新增配接器服務參考外掛程式] 或 [取用配接器服務載入巨集] 在 Visual Studio 中指定 URI,則必須在 [URI 屬性 ] 索引標籤中指定它們 as-is,也就是不使用任何逸出字元。 如果您直接在 [ 設定 URI ] 字段中指定 URI,而連接參數包含特殊字元,則必須使用適當的逸出字元來指定連接參數。

    例如,如果連線 URI 有名稱 sql server為 的參數,您必須將其指定為 sql%20server

  • 如果您在 BizTalk Server 管理控制台中建立傳送或接收埠時指定 URI,而且連接參數包含特殊字元,您必須使用適當的逸出字元來指定連接參數。

使用連線 URI 連線到 SQL Server 資料庫

以下是 SQL 配接器的範例連線 URI。

mssql://sql_server/sql_server_instance//  

在上述範例中,“sql_server”是安裝 SQL Server 的計算機名稱,而 “sql_server_instance” 是要連接的資料庫實例名稱。 因為未指定任何資料庫名稱,因此配接器會連線到預設資料庫。

以下是連接 URI 的範例,其中 SQL Server 資料庫安裝在與 SQL 配接器相同的電腦上。 在此範例中,適配器會連接到本機計算機上的資料庫實例「sql_server_instance」,以存取資料庫「my_database」。

mssql://localhost/sql_server_instance/my_database/  

在此範例中,配接器會連線到本機計算機上執行之預設實例的預設資料庫。

mssql://localhost///  

當您執行以下操作時,請參閱如何指定 SQL Server 資料庫連線的資訊:

另請參閱

開發 SQL 應用程式