CData Azure Data Lake Storage BizTalk Adapter の要請応答送信ポートを構成

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

ここでは、CData BizTalk Adapter for ADLS を使用し、静的な要請応答送信ポートを作成、構成、テストする手順を説明します。静的な要請応答送信ポートを使用してコマンドを実行し、BizTalk の結果にアクセスすることができます。送信ポートを使用することで、アップデートグラムコマンド、SQL コマンド、ストアドプロシージャ操作を実行できます。

送信ポートを作成し構成する

静的な要請応答送信ポートを作成し、アダプタをトランスポートタイプとして使用するように構成します。

1. 未実行の場合、BizTalk 管理コンソールで BizTalk アプリケーションを開きます。
2. BizTalk アプリのノードで、［Send Ports］を右クリックし、［New］->［Static Solicit-Response Send Port］を選択すると、送信ポートプロパティのダイアログが表示されます。
3. 送信ポートのプロパティで、受信ポートの名前を入力します。
4. ［Transport Type］メニューで、CData.ADLS を選択します。
5. ［Send Pipeline］メニューで、デフォルトオプションの［PassThruTransmit］を選択します。
6. ［Receive Pipeline］メニューで、デフォルトオプションの［PassThruReceive］を選択します。

アダプタを構成する

［Transport Properties］ダイアログで、アダプタが実行するコマンドを定義します。

1. 送信ポートのプロパティで、［Configure］ボタンをクリックします。アダプタのトランスポートプロパティダイアログが表示されます。
2. ［CommandType］プロパティで、実行したいコマンドタイプを選択します。
3. SQL コマンドを実行したい場合は、［SQL Command］のボックスにコマンドを入力してください。

Azure Data Lake Storage への接続を構成する

［Connection String Options］ダイアログで、Azure Data Lake Storage への接続に必要な資格情報とその他のプロパティを設定します。

1. 送信ポートのプロパティで、［Configure］をクリックします。アダプタのプロパティダイアログが表示されます。
2. ［Connection String］プロパティのボタンをクリックします。［Connection String Options］ダイアログが表示されます。
3. 接続プロパティを入力します。下は一般的な接続文字列です。

   Schema=ADLSGen2;Account=myAccount;FileSystem=myFileSystem;AccessKey=myAccessKey;

   Azure Data Lake Storage 接続プロパティの取得・設定方法

   Azure Data Lake Storage Gen 2 への接続

   Gen 2 Data Lake Storage アカウントに接続するには、以下のプロパティを設定します。

   • Account：ストレージアカウントの名前。
   • FileSystem：このアカウントに使用されるファイルシステム名。例えば、Azure Blob コンテナの名前。
   • Directory（オプション）：レプリケートされたファイルが保存される場所へのパス。パスが指定されない場合、ファイルはルートディレクトリに保存されます。

   Azure Data Lake Storage Gen 2 への認証

   本製品は、次の４つの認証方法をサポートします：アクセスキーの使用、共有アクセス署名の使用、Azure Active Directory OAuth（AzureAD）、Managed Service Identity（AzureMSI）。

   アクセスキー

   アクセスキーを使用して接続するには、はじめにADLS Gen2 ストレージアカウントで利用可能なアクセスキーを取得する必要があります。

   Azure ポータルで：

   1. ADLS Gen2 ストレージアカウントにアクセスします。
   2. 設定でアクセスキーを選択します。
   3. 利用可能なアクセスキーの1つの値をAccessKey 接続プロパティにコピーします。

   接続の準備ができたら、次のプロパティを設定します。

   • AuthScheme：AccessKey。
   • AccessKey：先にAzure ポータルで取得したアクセスキーの値。

   共有アクセス署名（SAS）

   共有アクセス署名を使用して接続するには、はじめにAzure Storage Explorer ツールを使用して署名を生成する必要があります。

   接続の準備ができたら、次のプロパティを設定します。

   • AuthScheme：SAS。
   • SharedAccessSignature：先に生成した共有アクセス署名の値。

   AzureAD、AzureMSI での認証方法については、ヘルプドキュメントの「Azure Data Lake Storage Gen 2 への認証」セクションを参照してください。

4. ［Test Connection］をクリックして値を確認し、接続を確認します。