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 資料庫連線的資訊:
使用取用配接器服務的 BizTalk 專案附加元件或新增配接器服務參考的 Visual Studio 外掛程式。請參閱在 Visual Studio 中使用 SQL 配接器連線到 SQL Server。
在 BizTalk Server 解決方案中設定傳送埠或接收埠(位置),請參閱 手動設定 SQL 配接器的實體埠系結。
在程式設計解決方案中使用 WCF 通道模型,請參閱 使用 SQL 配接器建立通道。
在程式設計解決方案中使用 WCF 服務模型,請參閱 設定 SQL 配接器的用戶端系結。