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

  • [アーティクル]

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

重要

アダプター サービス アドインを使用しているときに、string 型のバインド プロパティの値を指定せず、既定値が null の場合、そのバインド プロパティはバインド ファイルで使用できません。 必要に応じて、バインド プロパティとその値をバインド ファイルに手動で追加する必要があります。

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

Note

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

重要

アダプター メタデータの追加ウィザードを使用しても、WCF-SQL ポートを作成できるポート バインド ファイルは作成されません。 ただし、アダプター サービス アドインを使用して生成されたポート バインド ファイルに変更を加え、それを使用して WCF-SQL ポートを作成することもできます。 詳細については、「 アダプター サービス アドインを使用して生成されたポート バインド ファイルを使用した WCF-SQL ポートの構成」を参照してください。

アダプター サービス アドインを使用して生成されるバインド ファイルに関して理解しておく必要があるいくつかの重要なポイントを次に示します。

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

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

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

    重要

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

    重要

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

アダプター サービス アドインを使用して生成されたポート バインド ファイルを使用して WCF-SQL ポートを構成する

アダプター サービスアドインを使用すると、BizTalk Server管理コンソールでインポートできるポート バインド ファイルも作成されます。 同じポート バインド ファイルを使用して、管理コンソールで BizTalk WCF-SQL ポートBizTalk Server作成することもできます。 ただし、WCF-SQL ポートを作成する前に、次のタスクを実行してポート バインド ファイルを変更する必要があります。

  1. テキスト エディターでポート バインド ファイルを開きます。

  2. "WCF-Custom" を検索し、管理コンソールで WCF-SQL アダプターを追加した名前BizTalk Server置き換えます。 たとえば、WCF-SQL アダプターを "SQLAdapter" として追加した場合は、"WCF-Custom" を "SQLAdapter" に置き換えます。

  3. "ConfigurationClsid" 属性を検索し、属性の既存の値を "59B35D03-6A06-4734-A249-EF561254ECF7" に置き換えます。

  4. バインド ファイルを保存して閉じます。

  5. 管理コンソールでバインド ファイルBizTalk Serverインポートします。 バインド ファイルをインポートする方法については、「アダプター バインドを 再利用する」を参照してください。

参照

SQL アダプターを使用して BizTalk アプリケーションを開発するための構成要素