SQL アダプターを使用するようにポート バインド ファイルを使用して物理ポート バインドを構成する

アダプター サービス BizTalk プロジェクト アドインを使用して、スキーマ ファイル以外の SQL Server 成果物のメタデータを生成する場合、アダプター サービス アドインの使用によってポート バインド ファイルも生成されます。 このバインド ファイルを BizTalk アプリケーションにインポートして、物理送受信ポートを作成できます。 バインディング・ファイルのインポート手順については、 アダプター・バインディングの再利用を参照してください。 このバインド ファイルをインポートする場合は、物理送受信ポートを手動で作成する必要はありません。

ポート バインド ファイルを使用してポートを作成すると、常に双方向の送信ポートまたは一方向の受信ポートが作成されます。 一方向の送信ポートを作成する場合は、「 SQL アダプターへの物理ポート バインドを手動で構成する」の手順を使用して手動で作成できます。 または、このトピックに記載されている回避策に従って、ポート バインド ファイルを変更して一方向の送信ポートを作成することもできます。

Consume Adapter Service アドインが生成するバインディング ファイルに関して理解しておく必要があるいくつかの重要なポイントを次に示します。

• ファイルは、特定の名前付け規則で作成されます。 送信操作のメタデータ (つまり、SQL Server にメッセージを送信する) を生成した場合、ファイルの名前は WcfSendPort_SqlAdapterBinding_Custom.bindinginfo.xml。

  受信操作のメタデータ (つまり、SQL Server からメッセージを受信する) を生成した場合、ファイルの名前は WcfReceivePort_SqlAdapterBinding_Custom.bindinginfo.xml。

• このファイルには、メタデータが生成された操作に基づいて、バインド構成、バインドの種類、エンドポイント URI、およびポート アクションに関する情報が含まれています。 このバインド ファイルを BizTalk アプリケーションにインポートしてポートを作成すると、物理ポートの構成に必要なすべての関連情報がポートに自動的に設定されます。

  Von Bedeutung

  既定では、送信ポートのアクションは、メタデータを生成した操作名にマップされます。 たとえば、Customer テーブルに対する挿入操作のメタデータを生成する場合、ポートのアクションは <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" />

  Von Bedeutung

  受信操作の場合、ポート バインド ファイルは常に一方向の受信ポートを作成します。 これは、SQL アダプターが受信操作に対して一方向の受信ポートのみをサポートするためです。

Consume Adapter Service アドインを使って生成されたポートバインドファイルを使用して 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 アプリケーションを開発するための構成要素