Anypoint Studio を使用した Amazon DynamoDB Connector の設定 - Mule 4

Anypoint Studio (Studio) エディターは、Mule アプリケーション、プロパティ、および設定ファイルの設計と更新に役立ちます。

Studio でコネクタを追加および設定する手順は、次のとおりです。

Studio で初めてコネクタを設定する場合は、​「Anypoint Studio を使用したコネクタの設定」​を参照してください。このトピックを読んだ後に、コネクタ項目に関する追加情報が必要な場合は、​「Amazon DynamoDB Connector リファレンス」​を参照してください。

Mule プロジェクトを作成する

Studio で、コネクタを追加および設定する新しい Mule プロジェクトを作成します。

  1. Anypoint Studio で、​[File (ファイル)] > [New (新規)] > [Mule Project (Mule プロジェクト)]​ を選択します。

  2. Mule プロジェクトの名前を入力して、​[Finish (完了)]​ をクリックします。

コネクタを Mule プロジェクトに追加する

Amazon DynamoDB Connector を Mule プロジェクトに追加すると、自動的に XML コードにコネクタの名前空間およびスキーマの場所が入力され、プロジェクトの ​pom.xml​ ファイルに必要な連動関係が追加されます。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[(X) Search in Exchange ((X) Exchange 内を検索)]​ をクリックします。

  2. [Add Modules to Project (モジュールをプロジェクトに追加)]​ で、検索項目に「​amazon dynamodb​」と入力します。

  3. [Available modules (使用可能なモジュール)]​ で、​[Amazon DynamoDB]​ をクリックします。

  4. [Add (追加)]​ をクリックします。

  5. [Finish (完了)]​ をクリックします。

Studio でコネクタを Mule プロジェクトに追加しても、Studio ワークスペースの他のプロジェクトはそのコネクタを使用できません。

入力元を設定する

入力元は、指定された条件が満たされたときにフローを開始します。次の入力元のいずれかを設定して、Amazon DynamoDB Connector で使用できます。

  • HTTP Listener​: 設定されたホストとポートで要求を受信するたびにフローを開始

  • Scheduler​: 時間ベースの条件が満たされたときにフローを開始

たとえば、​HTTP リスナー​を設定する手順は、次のとおりです。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[HTTP]​ > ​[Listener]​ を選択します。

  2. [Listener]​ を Studio キャンバスにドラッグします。

  3. [Listener]​ タブで、必要に応じて ​[Display Name (表示名)]​ 項目の値を変更します。

  4. [Path (パス)]​ 項目の値を指定します。

  5. [Connector configuration (コネクタ設定)]​ 項目の横にあるプラス記号 (+) をクリックして、アプリケーション内のすべての ​HTTP Listener​ インスタンスで使用できるグローバル要素を設定します。

  6. [General (一般)]​ タブで、接続情報を指定します。

  7. [TLS]​ タブで、必要に応じて TLS 情報を指定します。

  8. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  9. [Test Connection (接続をテスト)]​ をクリックして、Mule が特定のサーバーに接続できることを確認します。

  10. [OK]​ をクリックします。

フローにコネクタの操作を追加する

フローにコネクタの操作を追加すると、そのコネクタで実行する特定の操作をすぐに定義できます。

Amazon DynamoDB Connector の操作を追加するには、次の手順に従います。

  1. [Mule Palette (Mule パレット)]​ ビューで、​[Amazon DynamoDB]​ を選択し、目的の操作を選択します。

  2. その操作を Studio キャンバスの入力元の右にドラッグします。

コネクタのグローバル要素を設定する

コネクタを設定する場合、最適なのはアプリケーション内のそのコネクタのすべてのインスタンスで使用できるグローバル要素を設定することです。グローバル要素の設定では、コネクタが対象の Amazon DynamoDB システムにアクセスするために使用する認証ログイン情報を提供する必要があります。Amazon DynamoDB Connector では、基本認証とロール認証の両方がサポートされています。

Amazon DynamoDB Connector のグローバル要素を設定する手順は、次のとおりです。

  1. Studio キャンバスでコネクタを選択します。

  2. 操作の設定画面で、​Connector configuration​ 項目の横にあるプラス記号 (+) をクリックし、グローバル要素設定項目にアクセスします。

  3. [General (一般)]​ タブで、​「基本認証」​および​「ロール認証」​セクションの説明に従って基本認証またはロール認証を設定します。

    ANT スタイルのプロパティプレースホルダーを含む設定ファイルを参照するか (推奨)、グローバル設定プロパティに認証ログイン情報を入力できます。ANT スタイルのプロパティホルダーの使用についての詳細は、​「Anypoint Connector 設定」​を参照してください。

  4. [Advanced (詳細)]​ タブで、必要に応じて再接続戦略を含む再接続情報を指定します。

  5. [Test Connection (接続をテスト)]​ をクリックして、Mule が指定されたサーバーに接続できることを確認します。

  6. [OK]​ をクリックします。

基本認証

[Global Element Properties (グローバル要素のプロパティ)]​ 画面の ​[General (一般)]​ タブで次の情報を入力し、基本認証を設定します。

項目 ユーザーアクション

Name (名前)

設定名を入力します。

Connection (接続)

[Basic (基本)]​ を選択します。

Session Token (セッショントークン)

必要に応じて、Amazon Security Token Service (STS) が提供するセッショントークンを入力します。

Access Key (アクセスキー)

Amazon が提供するアクセスキーを入力します。

Secret Key (シークレットキー)

Amazon が提供するシークレットキーを入力します。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

AWS 環境からログイン情報を取得するには、​true​ に設定します。

Region Endpoint (リージョンエンドポイント)

サービスのリージョンエンドポイントを選択します。

次のスクリーンショットは、基本認証の設定例を示しています。

[Connection (接続)] 項目で [Basic (基本)] オプションが選択されています
Figure 1. 基本認証の項目

最初の項目は、コネクタが基本認証を使用することを指定する場所を示しています。2 番目の項目は、基本認証に関連する項目を含む ​[General (一般)]​ タブを示しています。

ロール認証

グローバル要素設定画面の ​[General (一般)]​ タブで次の情報を入力し、ロール認証を設定します。

項目 ユーザーアクション

Name (名前)

設定名を入力します。

Connection (接続)

[Role (ロール)]​ を選択します。

Role ARN (ロール ARN)

クロスアカウントアクセスを取得することを前提とするロールを入力します。

Access Key (アクセスキー)

Amazon が提供するアクセスキーを入力します。

Secret Key (シークレットキー)

Amazon が提供するシークレットキーを入力します。

Try Default AWS Credentials Provider Chain (デフォルトの AWS ログイン情報プロバイダーチェーンを試す)

AWS 環境からログイン情報を取得するには、​true​ に設定します。

Region Endpoint (リージョンエンドポイント)

サービスのリージョンエンドポイントを選択します。

次のスクリーンショットは、ロール認証の設定例を示しています。

[Connection (接続)] 項目で [Role (ロール)] オプションが選択されています
Figure 2. ロール認証の項目

最初の項目は、コネクタがロール認証を使用することを指定する場所を示しています。2 番目の項目は、ロール認証に関連する項目を含む ​[General (一般)]​ タブを示しています。

その他のコネクタ項目の設定

Amazon DynamoDB Connector のグローバル要素を設定したら、コネクタの他の必須項目を設定します。

項目 説明

Table name (テーブル名)

作成するテーブルの名前。

Attribute definitions (属性定義)

テーブルとそのインデックスのキースキーマを記述する属性。

Key schemas (キースキーマ)

テーブルまたはインデックスの主キーを構成する属性。