建立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 屬性 ] 索引標籤中指定它們,也就是不使用任何逸出字元。 如果您直接在 [ 設定 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 外掛程式,請參閱使用 SQL 配接器連線至 Visual Studio 中的SQL Server。
在BizTalk Server解決方案中設定傳送埠或接收埠 (位置) ,請參閱手動設定 SQL 配接器的實體埠系結。
在程式設計解決方案中使用 WCF 通道模型,請參閱 使用 SQL 配接器建立通道。
在程式設計解決方案中使用 WCF 服務模型,請參閱 設定 SQL 配接器的用戶端系結。