Amazon Web ServicesのDynamoDBのテーブルからアイテムを取得します
「DynamoDB Browser」からテーブル名 、インデックス名 、ハッシュ属性名 、ハッシュ属性型 、レンジ属性名 、レンジ属性型 の各プロパティを設定することができます。
「DynamoDB Browser」の詳細については下記トピック「DynamoDB Browserの使い方」を参照してください。
入力 | フォーマット | すべて | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
接続数 | 1 | ||||||||||||||||
説明 | 入力ストリームは使用せず、すべて無視します。 | ||||||||||||||||
出力 | フォーマット | Record | |||||||||||||||
説明 |
コンポーネントをフローに配置したときにはフィールドは定義されていませんので、取得したい属性名をフィールドに追加してください。
フィールド定義のデータ型によって自動的にDynamoDBのデータ型を決めてデータを取得します。 追加した属性のデータ型が取得したデータ型と異なる場合は値が返されませんので、下記の表でデータ型を確認して指定してください。
|
名前 | プロパティ型 | マッピング | 説明 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
コネクションを使用 | boolean | - |
接続情報に以下のコネクション名 を使用するかどうか選択します。
|
|||||||||||||||||||||
コネクション名 | connection | - | コネクションを使用 が「はい」の場合に接続先のAWSを指定します。 コネクションペインまたは管理コンソールにて作成されたAWS接続名を選択します。 | |||||||||||||||||||||
コネクション情報 | group | - | コネクションを使用 が「いいえ」の場合に使用されるプロパティ群です。 | |||||||||||||||||||||
アクセスキー | string | 入力&出力 |
アクセスキーを指定します。
サーバーがEC2インスタンス上にあり、アクセスキーを指定しない場合は、EC2インスタンスに設定されたIAMロールを使用します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
|||||||||||||||||||||
シークレットキー | password | 入力&出力 |
シークレットキーを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
|||||||||||||||||||||
プロトコル | choice | 入力&出力 |
FSMCで設定したプロキシーサーバーを使用する場合、「プロキシの設定」で設定されたプロキシ情報の選択に使用します。
コネクションを使用 が「いいえ」の場合、かつプロキシ設定を使用 が「はい」の場合、この設定を参照します。
|
|||||||||||||||||||||
タイムアウト(秒) | int | 入力&出力 |
リクエスト時およびコネクション接続時のソケットタイムアウト時間を秒単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
|||||||||||||||||||||
リクエストタイムアウト(分) | int | 入力&出力 |
1回のリクエスト実行のタイムアウトまでの時間を分単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
|||||||||||||||||||||
リージョン | choice | 入力&出力 |
利用するAWSのリージョンを選択します。
選択肢にない場合はリージョンを表す文字列を入力することもできます。 例えば東京リージョンであれば ap-northeast-1を指定します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
|||||||||||||||||||||
AssumeRole ARN | string | 入力&出力 |
一時的な認証情報を使用するためにAssumeRoleのARNを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
|||||||||||||||||||||
一時的認証情報の有効期限(秒) | int | 入力&出力 |
AssumeRole ARNで設定する一時的な認証情報の有効期限を秒単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
|||||||||||||||||||||
プロキシ設定を使用 | boolean | 入力&出力 |
管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
|
|||||||||||||||||||||
テーブル名 | string | 入力&出力 | アイテムを取得するテーブル名を指定します。 | |||||||||||||||||||||
検索方法 | choice | 入力&出力 |
検索方法を選択します。
|
|||||||||||||||||||||
インデックス名 | string | 入力&出力 | 取得するアイテムをインデックスから検索する場合にインデックス名を指定します。 | |||||||||||||||||||||
条件式 | string | 入力&出力 | 取得したアイテムをフィルターするための条件式を指定します。 詳細については下記トピック「条件式とパラメーター」を参照してください。 | |||||||||||||||||||||
ハッシュ属性名 | string | 入力&出力 |
ハッシュ属性名を指定します。
インデックス名を指定している場合はインデックスのハッシュ属性名を指定してください。 |
|||||||||||||||||||||
ハッシュ属性型 | choice | 入力&出力 |
ハッシュ属性の型を選択します。
|
|||||||||||||||||||||
ハッシュ属性値 | string | 入力&出力 | ハッシュ属性値を指定します。 | |||||||||||||||||||||
レンジ属性名 | string | 入力&出力 |
レンジ属性名を指定します。
インデックス名を指定している場合はインデックスのレンジ属性名を指定してください。 |
|||||||||||||||||||||
レンジ属性型 | choice | 入力&出力 |
レンジ属性の型を選択します。
|
|||||||||||||||||||||
レンジ比較演算子 | choice | 入力&出力 |
レンジ属性の比較演算子を選択します。
|
|||||||||||||||||||||
レンジ属性値 | string | 入力&出力 | レンジ属性値を指定します。 | |||||||||||||||||||||
レンジ属性値2 | string | 入力&出力 | レンジ比較演算子で「Between」を選択した場合にもう1つのレンジ属性値を指定します。 | |||||||||||||||||||||
並び順 | choice | 入力&出力 |
結果の並び順を指定します。
|
|||||||||||||||||||||
ループを開始 | loopProcess | - |
結果をまとめて出力するか、1レコードずつループして出力するかを選択します。
|
|||||||||||||||||||||
アイテムがない場合エラー | boolean | - |
結果が取得できなかった場合にエラーを発生するかどうかを選択します。
|
|||||||||||||||||||||
条件式(属性名)パラメーター | category | 入力&出力 | 条件式の中で指定する属性名をパラメーターとして使用することができます。
主に、属性名としてDynamoDBの予約語を使用している場合にこのプロパティを使用します。 また、#osfieldから始まる名前は使用できません。
|
|||||||||||||||||||||
条件式(属性値)パラメーター | category | 入力&出力 | 条件式の中で指定する属性値をパラメーターとして使用することができます。
|
結果が複数あり、ループを開始が「true」の場合、
このコンポーネントがループの起点となってレコードを1つずつ出力します。
ループする場合でも初回の実行時にすべてのデータを保持します。
コミット | 何もしません。 |
---|---|
ロールバック | 何もしません。 |
タイプ | パラメーター | エラー処理フロー
へのストリーム | エラー
コード | 説明 |
---|---|---|---|---|
汎用 | なし | コンポーネントの入力ストリーム | 1 | コネクションの定義項目に不正な値があった場合 |
2 | 必須のプロパティの項目が指定されていなかった場合 | |||
4 | 指定した検索方法が不正な場合 | |||
5 | プライマリキーに指定している型が不正な場合 | |||
7 | 条件式(属性名)パラメーター名が不正な場合 | |||
8 | 条件式(属性値)パラメーター名が不正な場合 | |||
1001 | APIクライアントの初期化に失敗した場合 | |||
アイテムが存在しない | なし | コンポーネントの入力ストリーム | 3 | アイテムがない場合エラーが「true」の場合でアイテムが取得できなかった場合 |
APIエラー | 「APIエラーの
パラメーター」を 参照してください。 | コンポーネントの入力ストリーム | 202 | 認証に失敗した場合。
APIの実行でエラーコードAccessDeniedExceptionを受け取った場合が該当します。 |
203 | リクエストの頻度が多すぎる場合。
APIの実行でエラーコードProvisionedThroughputExceededExceptionを受け取った場合が該当します。 |
|||
204 | テーブルの状態が無効な場合。
APIの実行でエラーコードResourceNotFoundExceptionを受け取った場合が該当します。 |
|||
205 | AWSアクセスキーIDまたはシークレットキーが無効である場合。
APIの実行でエラーコードUnrecognizedClientExceptionを受け取った場合が該当します。 |
|||
206 | 必須パラメータが指定されていないなどの場合。
APIの実行でエラーコードValidationExceptionを受け取った場合が該当します。 |
|||
201 | APIの実行で上記以外のエラーコードを受け取った場合。 | |||
接続エラー | なし | コンポーネントの入力ストリーム | 301 | 接続に失敗した場合。 |
APIエラーが発生したときに設定されるエラーのパラメーターです。
No. | 名前 | 説明 |
---|---|---|
1 | Code | AWSから取得したエラーコード。エラーの詳細につきましては、AWSのサイトを参照ください。 |
2 | Message | AWSから取得したエラーの内容。エラーの詳細につきましては、AWSのサイトを参照ください。 |
条件式 | 条件式(属性値)パラメーターの名前 | 条件式(属性値)パラメーターのデータ型 | 条件式(属性値)パラメーターの値 |
---|---|---|---|
ID > :id | :id | Number | 10 |
条件式 | 条件式(属性値)パラメーターの名前 | 条件式(属性値)パラメーターのデータ型 | 条件式(属性値)パラメーターの値 |
---|---|---|---|
ID > :id and UserName = :username | :id | Number | 10 |
:username | String | A |
条件式 | 条件式(属性名)パラメーターの名前 | 条件式(属性名)パラメーターの値 | 条件式(属性値)パラメーターの名前 | 条件式(属性値)パラメーターの値 |
---|---|---|---|---|
#groupid = :support | #groupid | Group.ID | :support | ABC |
本コンポーネントをダブルクリックするか、右クリックメニューの「DynamoDB Browser」を実行すると、DynamoDB Browserが起動します。
DynamoDB Browserはテーブルプロパティを設定するために使用しますが、DynamoDBへの簡単な操作も行えます。