使用埠系結檔案設定實體埠系結以使用 SQL 配接器

當您使用取用配接器服務 BizTalk 專案增益集來產生SQL Server成品的中繼資料時，除了架構檔案以外，取用配接器服務增益集也會產生埠系結檔案。 您可以將此系結檔案匯入 BizTalk 應用程式，以建立實體傳送或接收埠。 如需匯入系結檔案的指示，請參閱 重複使用配接器系結。 如果您匯入此系結檔案，就不需要手動建立實體傳送或接收埠。

重要

使用取用配接器服務增益集時，如果您未為字串類型的系結屬性指定值，且其預設值為 null，則系結檔案中將無法使用該系結屬性。 如有必要，您必須在系結檔案中手動新增系結屬性及其值。

使用埠系結檔案建立埠一律會建立雙向傳送埠或單向接收埠。 如果您想要建立單向傳送埠，您可以使用 手動設定實體埠系結至 SQL 配接器中的步驟手動建立。 或者，您可以遵循本主題中所述的因應措施來修改埠系結檔案，以建立單向傳送埠。

注意

針對輸入作業，埠系結檔案一律會建立單向接收埠。 這是因為 SQL 配接器只支援輸入作業的單向接收埠。

重要

使用 [新增配接器中繼資料精靈] 不會建立埠系結檔案，您可以使用該檔案來建立 WCF-SQL 埠。 不過，您可以對取用配接器服務增益集所產生的埠系結檔案進行一些變更，並用它來建立 WCF-SQL 埠。 如需詳細資訊，請參閱 使用取用配接器服務增益集所產生的埠系結檔案來設定 WCF-SQL 埠。

以下是您必須瞭解使用配接器服務增益集所產生的系結檔案的一些重點：

• 檔案是使用特定的命名慣例所建立。 如果您產生輸出作業的中繼資料，也就是說，若要將訊息傳送至SQL Server，則檔案的名稱會 WcfSendPort_SqlAdapterBinding_Custom.bindinginfo.xml。

  如果您為輸入作業產生中繼資料，也就是從SQL Server接收訊息，檔案的名稱會 WcfReceivePort_SqlAdapterBinding_Custom.bindinginfo.xml。

• 檔案包含系結組態、系結類型、端點 URI，以及根據產生中繼資料之作業的埠動作的相關資訊。 當您將此系結檔案匯入 BizTalk 應用程式以建立埠時，所有設定實體埠所需的相關資訊都會在埠上自動設定。

  重要

  根據預設，傳送埠上的動作會對應至您產生中繼資料的作業名稱。 例如，如果您在 Customer 資料表上產生 Insert 作業的中繼資料，埠上的動作會設定為 <Operation Name="Insert" Action="TableOp/Insert/dbo/CustomerTable" /> 。 不過，您在 BizTalk 協調流程中建立之邏輯傳送埠上的作業名稱可能不相同。 您必須確定 BizTalk 協調流程中的邏輯傳送埠 (中的作業名稱) ，以及 BizTalk Server 管理主控台中實體傳送埠 () 相同。 如果沒有，您會在透過傳送埠將訊息傳送至SQL Server時收到錯誤。

• 您只需要提供埠的認證，才能連線到SQL Server。 雖然系結檔案會保留要連線的使用者名稱，但基於安全性理由，系結檔案不包含密碼。

使用埠系結檔案的主要考慮

• 當您匯入系結檔案時，可能會收到對話方塊訊息，告知系結檔案中的 BizTalk 應用程式名稱與您要匯入系結檔案的應用程式名稱不符。 您可以放心地忽略此訊息並繼續。

• 系結檔案也包含埠和接收位置的名稱。 如果您要匯入系結檔的 BizTalk 應用程式會建立埠或接收位置，該位置的名稱與相同 BizTalk 應用程式中已經存在的埠相同，您將會收到錯誤。 您必須手動編輯系結檔案，以指定埠或接收位置的唯一名稱。

• 系結檔案也包含連線 URI 的相關資訊。 如果系結檔案建立的接收位置與相同 BizTalk 應用程式中已有的現有接收位置具有相同的接收 URI，您會收到錯誤。 您必須手動編輯系結檔案，以指定唯一的 URI。

• 根據預設，輸出作業的埠系結檔案一律包含雙向傳送埠的定義。 當您在 BizTalk 應用程式中匯入此檔案時，它會建立雙向傳送埠。 不過，您可能有具有單向傳送埠的協調流程。 因此，當您設定這類協調流程並使用匯入系結檔案所建立的埠時，此埠將無法在清單中使用。 這是因為您在協調流程中建立的邏輯埠是單向埠，而協調流程中建立的實體埠是雙向埠。 在這種情況下，您可以編輯系結檔案以進行下列變更：

  針對此

  執行方式

  編輯埠系結檔案以設定單向傳送埠

  1.在下列摘錄中，將 IsTwoWay 屬性的值變更為 false。 最初，這會設定為 true。 <SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0"> 2.將下列摘錄批註化： <ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="1" TrackingOption="None" Description=""/> <ReceivePipelineData xsi:nil="true" />

  重要

  針對輸入作業，埠系結檔案一律會建立單向接收埠。 這是因為 SQL 配接器只支援輸入作業的單向接收埠。

使用使用取用配接器服務增益集產生的埠系結檔案設定 WCF-SQL 埠

取用配接器服務增益集也會建立埠系結檔案，您可以在 BizTalk Server 管理主控台中匯入。 您可以使用相同的埠系結檔案，在 BizTalk Server 管理主控台中建立 BizTalk WCF-SQL 埠。 不過，在建立 WCF-SQL 埠之前，您必須執行下列工作來修改埠系結檔案。

1. 在文字編輯器中開啟埠系結檔案。

2. 搜尋並將 「WCF-Custom」 取代為您在 BizTalk Server 管理主控台中新增 WCF-SQL 配接器的名稱。 例如，如果您將 WCF-SQL 配接器新增為 「SQLAdapter」，請將 「WCF-Custom」 取代為 「SQLAdapter」。

3. 搜尋 「ConfigurationClsid」 屬性，並將屬性的現有值取代為 「59B35D03-6A06-4734-A249-EF561254ECF7」。

4. 儲存並關閉系結檔案。

5. 在 BizTalk Server 管理主控台中匯入系結檔案。 如需如何匯入系結檔案的指示，請參閱 重複使用配接器系結。

另請參閱

使用 SQL 配接器開發 BizTalk 應用程式的建置組塊