CData Azure Data Lake Storage BizTalk Adapter の要請応答送信ポートを構成
Biztalk Adapter を要請応答送信ポートと共に使用して、BizTalk でアップデートグラムとデータ操作 SQL を実行します。
加藤龍彦
デジタルマーケティング
最終更新日:2021-07-17
CData
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
ここでは、CData BizTalk Adapter for ADLS を使用し、静的な要請応答送信ポートを作成、構成、テストする手順を説明します。静的な要請応答送信ポートを使用してコマンドを実行し、BizTalk の結果にアクセスすることができます。送信ポートを使用することで、アップデートグラムコマンド、SQL コマンド、ストアドプロシージャ操作を実行できます。
送信ポートを作成し構成する
静的な要請応答送信ポートを作成し、アダプタをトランスポートタイプとして使用するように構成します。
- 未実行の場合、BizTalk 管理コンソールで BizTalk アプリケーションを開きます。
- BizTalk アプリのノードで、[Send Ports]を右クリックし、[New]->[Static Solicit-Response Send Port]を選択すると、送信ポートプロパティのダイアログが表示されます。
- 送信ポートのプロパティで、受信ポートの名前を入力します。
- [Transport Type]メニューで、CData.ADLS を選択します。
- [Send Pipeline]メニューで、デフォルトオプションの[PassThruTransmit]を選択します。
- [Receive Pipeline]メニューで、デフォルトオプションの[PassThruReceive]を選択します。
アダプタを構成する
[Transport Properties]ダイアログで、アダプタが実行するコマンドを定義します。
- 送信ポートのプロパティで、[Configure]ボタンをクリックします。アダプタのトランスポートプロパティダイアログが表示されます。
- [CommandType]プロパティで、実行したいコマンドタイプを選択します。
- SQL コマンドを実行したい場合は、[SQL Command]のボックスにコマンドを入力してください。
プロパティとその機能についての説明は、
ヘルプドキュメントの[Adapter Configuration]を参照してください。
Azure Data Lake Storage への接続を構成する
[Connection String Options]ダイアログで、Azure Data Lake Storage への接続に必要な資格情報とその他のプロパティを設定します。
- 送信ポートのプロパティで、[Configure]をクリックします。アダプタのプロパティダイアログが表示されます。
- [Connection String]プロパティのボタンをクリックします。[Connection String Options]ダイアログが表示されます。
- 接続プロパティを入力します。下は一般的な接続文字列です。
Schema=ADLSGen2;Account=myAccount;FileSystem=myFileSystem;AccessKey=myAccessKey;
Azure DataLakeStorage 接続プロパティの取得・設定方法
Azure DataLakeStorage Gen 1 への接続
Gen 1 DataLakeStorage アカウントに接続するには、はじめに以下のプロパティを設定します。
- Schema:ADLSGen1 を指定。
- Account:アカウント名に設定。
- AzureTenant:テナントId に設定。Azure Portal 内のAzure Data Lake プロパティから取得できます。
- Directory:(オプション)複製したファイルを格納するためのパスを設定。指定しない場合は、ルートディレクトリが使用されます。
Azure DataLakeStorage Gen 1 への認証
Gen 1 は、認証方法としてAzure Active Directory OAuth(AzureAD)およびマネージドサービスID(AzureMSI)をサポートしています。認証方法は、ヘルプドキュメントの「Azure DataLakeStorage Gen 1
への認証」セクションを参照してください。
Azure DataLakeStorage Gen 2 への接続
Gen 2 DataLakeStorage アカウントに接続するには、はじめに以下のプロパティを設定します。
- Schema:ADLSGen2 に設定。
- Account:ストレージアカウント名に設定。
- FileSystem:このアカウントで使用するファイルシステム名に設定。例えば、Azure Blob コンテナ名など。
- Directory:(オプション)複製したファイルを格納するためのパスを設定。指定しない場合は、ルートディレクトリが使用されます。
Azure DataLakeStorage Gen 2 への認証
Gen 2は、認証方法としてアクセスキー、共有アクセス署名(SAS)、Azure Active Directory
OAuth(AzureAD)、マネージドサービスID(AzureMSI)など多様な方法をサポートしています。AzureAD、AzureMSI での認証方法は、ヘルプドキュメントの「Azure DataLakeStorage Gen 2
への認証」セクションを参照してください。
アクセスキーを使用した認証
アクセスキーを使用して接続するには、AccessKey プロパティを取得したアクセスキーの値に、AuthScheme を「AccessKey」に設定します。
Azure ポータルからADLS Gen2 ストレージアカウントのアクセスキーを取得できます。
- Azure ポータルのADLS Gen2 ストレージアカウントにアクセスします。
- 設定で「アクセスキー」を選択します。
- 利用可能なアクセスキーの1つの値を「AccessKey」接続プロパティにコピーします。
共有アクセス署名(SAS)
共有アクセス署名を使用して接続するには、SharedAccessSignature プロパティを接続先リソースの有効な署名に設定して、AuthScheme を「SAS」に設定します。
共有アクセス署名は、Azure Storage Explorer などのツールで生成できます。
- [Test Connection]をクリックして値を確認し、接続を確認します。
プロパティとその機能の説明については、
ヘルプドキュメントの[Connection String Options]チャプターを参照してください。
[
アダプタfor ADLS のアップデートグラムチュートリアル]では、要請応答送信ポートを使用して、Azure Data Lake Storage にアップデートグラムを挿入するシンプルなアプリケーションを作成する手順を説明します。