CData BizTalk Adapter for Amazon S3 に一方向送信ポートを構成

詳細情報をご希望ですか?

無償トライアル:

ダウンロードへ

製品の詳細情報へ:

Amazon S3 BizTalk Adapter

パワフルなBizTalk Adapter を使って標準オーケストレーションで、Amazon S3 クラウドストレージに連携。

Amazon S3 Adapter を使って、S3 のバケットやオブジェクトを簡単に同期。データ同期、ローカルバックアップ、ワークフロー自動化に最適!



Adapter for Amazon S3 を一方向送信ポートと兼用することにより、BizTalk でアップデートグラムとデータ操作SQL を実行できます。

ここでは、CData BizTalk Adapter for Amazon S3 を使用して静的な一方向送信ポートを作成、構成、テストする手順を説明します。静的な一方向送信ポートを使用することで、アップデートグラム、SQL コマンド、ストアドプロシージャを実行できます。送信ポートは、 返答データを持たない Amazon S3 データ変更の操作に役立ちます。通常、これはDELETE またはUPDATE のSQL コマンドか、アップデートグラムですが、場合によっては、ストアドプロシージャになります。

SELECT コマンドの実行や、作成したレコードId の取得のような、応答するアクションをトリガーする場合は、要請応答送信ポートを使用します。

一方向送信ポートを作成し実行する

静的な一方向送信ポートを作成し、Amazon S3 アダプタをトランスポートタイプとして使用するように構成します。

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

アダプタを構成する

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

  1. 送信ポートのプロパティで、[Configure]ボタンをクリックします。CData.Amazon S3 トランスポートプロパティのダイアログが表示されます。
  2. [CommandType]プロパティで、実行したいコマンドタイプを選択します。
  3. SQL コマンドを実行したい場合は、[SQL Command]のボックスにコマンドを入力してください。
プロパティとその機能についての説明は、ヘルプドキュメントの[Adapter Configuration]を参照してください。

Amazon S3 への接続を構成する

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

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

    AccessKey=a123;SecretKey=s123;

    Amazon S3 リクエストを認可するには、管理者アカウントまたはカスタム権限を持つIAM ユーザーの認証情報を入力します。AccessKey をアクセスキーID に設定します。SecretKey をシークレットアクセスキーに設定します。

    Note: AWS アカウント管理者として接続できますが、AWS サービスにアクセスするにはIAM ユーザー認証情報を使用することをお勧めします。

    アクセスキーの取得

    IAM ユーザーの資格情報を取得するには:

    1. IAM コンソールにサインインします。
    2. ナビゲーションペインで[ユーザー]を選択します。
    3. ユーザーのアクセスキーを作成または管理するには、ユーザーを選択してから[セキュリティ認証情報]タブを選択します。

    AWS ルートアカウントの資格情報を取得するには:

    1. ルートアカウントの資格情報を使用してAWS 管理コンソールにサインインします。
    2. アカウント名または番号を選択し、表示されたメニューで[My Security Credentials]を選択します。
    3. [Continue to Security Credentials]をクリックし、[Access Keys]セクションを展開して、ルートアカウントのアクセスキーを管理または作成します。

    AWS ロールとして認証

    多くの場合、認証にはAWS ルートユーザーのダイレクトなセキュリティ認証情報ではなく、IAM ロールを使用することをお勧めします。RoleARN を指定することでAWS ロールを代わりに使用できます。これにより、本製品は指定されたロールの資格情報を取得しようと試みます。

    (すでにEC2 インスタンスなどで接続されているのではなく)AWS に接続している場合は、ロールを引き受けるIAM ユーザーのAccessKey とSecretKey を追加で指定する必要があります。AWS ルートユーザーのAccessKey および SecretKey を指定する場合、ロールは使用できません。

    SSO 認証

    SSO 認証を必要とするユーザーおよびロールには、RoleARN およびPrincipalArn 接続プロパティを指定してください。各Identity Provider に固有のSSOProperties を指定し、AccessKey とSecretKey を空のままにする必要があります。これにより、本製品は一時的な認証資格情報を取得するために、リクエストでSSO 認証情報を送信します。

  5. [Test Connection]をクリックして値を確認し、接続を確認します。
プロパティとその機能の説明については、ヘルプドキュメントの[Connection String Options]チャプターを参照してください。

接続に成功し、アダプターが実行するコマンドを定義することで、送信ポートを使用できるようになります。アプリケーションで一方向送信ポートを使用する例については、次のセクションを参照してください。アプリケーションはファイルに含まれているアップデートグラムコマンドを読み取り、送信ポートを使用してコマンドを実行します。

この例ではフィルターを利用して、アップデートグラムを含むメッセージを受信場所から送信ポートに移動します。フィルターについてのより詳しい説明は次のセクションを参照してください。

フィルターを作成し、アプリケーションを介してBizTalk メッセージをルーティングする

送信ポートを必要なメッセージに関連付けるには、その送信ポートのプロパティの[Filters]セクションでフィルタールールを作成します。条件に一致するメッセージは、送信ポートにルーティングされます。受信場所でのフィルタリングに関しては、次の例を参照してください。

例:一方向送信ポートでアップデートグラムを実行する

このセクションでは、一方向送信ポートをアプリケーションで使用する方法について説明します。アプリケーションはファイルに含まれているアップデートグラムコマンドを読み取り、コマンドを実行します。

  1. 一方向受信場所はアップデートグラムを含むXML ドキュメントをピックアップします。
  2. 受信場所は、コマンドの結果を含むBizTalk メッセージを作成します。
  3. 一方向送信ポートは、受信場所のURI をフィルタリングします。ドキュメントは一方向送信ポートにルーティングされます。
  4. 送信ポートは、アップデートグラムコマンドを実行します。

前の例と同様に次のステップでは、ファイルからアップデートグラムを読み取るための受信場所を設定し、送信ポートを使用してコマンドを実行する方法を説明します。

  1. 静的な一方向の受信場所を作成、構成します。転送タイプのファイルを使用します。「CData BizTalk Adapter for Amazon S3 の受信場所を作成、構成する」と同じ手順に従います。
  2. 静的な一方向送信ポートを作成します。
  3. 送信ポートのプロパティで、[Filters]をクリックします。
  4. 空のプロパティで、次の値を設定します。
    プロパティ
    メニューから BTS.InboundTransportLocation を選択します。
    新しく作成された一方向受信場所のURI を入力します。