ここでは、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;
Authenticating to a Gen 1 DataLakeStore Account
Gen 1 uses OAuth 2.0 in Azure AD for authentication.
For this, an Active Directory web application is required. You can create one as follows:
- Sign in to your Azure Account through the
[.
]- Select "Azure Active Directory".
- Select "App registrations".
- Select "New application registration".
- Provide a name and URL for the application. Select Web app for the type of application you want to create.
- Select "Required permissions" and change the required permissions for this app. At a minimum, "Azure Data Lake" and "Windows Azure Service Management API" are required.
- Select "Key" and generate a new key. Add a description, a duration, and take note of the generated key. You won't be able to see it again.
To authenticate against a Gen 1 DataLakeStore account, the following properties are required:
- Schema: Set this to ADLSGen1.
- Account: Set this to the name of the account.
- OAuthClientId: Set this to the application Id of the app you created.
- OAuthClientSecret: Set this to the key generated for the app you created.
- TenantId: Set this to the tenant Id. See the property for more information on how to acquire this.
- Directory: Set this to the path which will be used to store the replicated file. If not specified, the root directory will be used.
Authenticating to a Gen 2 DataLakeStore Account
To authenticate against a Gen 2 DataLakeStore account, the following properties are required:
- Schema: Set this to ADLSGen2.
- Account: Set this to the name of the account.
- FileSystem: Set this to the file system which will be used for this account.
- AccessKey: Set this to the access key which will be used to authenticate the calls to the API. See the property for more information on how to acquire this.
- Directory: Set this to the path which will be used to store the replicated file. If not specified, the root directory will be used.
- [Test Connection]をクリックして値を確認し、接続を確認します。
プロパティとその機能の説明については、ヘルプドキュメントの[Connection String Options]チャプターを参照してください。
[
アダプタfor ADLS のアップデートグラムチュートリアル]では、要請応答送信ポートを使用して、Azure Data Lake Storage にアップデートグラムを挿入するシンプルなアプリケーションを作成する手順を説明します。