AWS DynamoDBPut - AWS DynamoDBのテーブルへアイテムを登録する

Amazon Web ServicesのDynamoDBのテーブルへアイテムを登録します

DynamoDBへの接続情報を設定することで「DynamoDB Browser」からテーブル名 プロパティを選択することができます。
「DynamoDB Browser」の詳細については下記トピック「DynamoDB Browserの使い方」を参照してください。

■ストリーム情報

入力フォーマットParameterList,Record,CSV,FixedLength
接続数1
説明 入力ストリームのフィールド定義に従ってアイテムを登録します。
フィールド定義のデータ型によって自動的にDynamoDBのデータ型に割り当てられます。
フィールド定義データ型DynamoDBデータ型
BooleanBoolean
IntegerNumber
DecimalNumber
DoubleNumber
StringString
BinaryBinary
DateTimeString
出力フォーマットRecord
説明 登録したアイテムの情報を返します。
コンポーネントをフローに配置したときには登録結果(RequestStatus/Boolean)、ハッシュ属性(HashKey/String)、レンジ属性(RangeKey/String)がフィールドに追加してあります。取得したい属性名をフィールドに追加してください。
フィールド定義のデータ型によって自動的にDynamoDBのデータ型を決めてデータを取得します。
追加した属性のデータ型が取得したデータ型と異なる場合は値が返されませんので、下記の表でデータ型を確認して指定してください。
フィールド定義データ型DynamoDBデータ型
BooleanBoolean
IntegerNumber
DecimalNumber
DoubleNumber
StringString
BinaryBinary
DateTimeString

■コンポーネントプロパティ

名前プロパティ型マッピング説明
コネクションを使用boolean- 接続情報に以下のコネクション名 を使用するかどうか選択します。
はい [true] - 以下のコネクション名 で指定した接続情報を使用します。
いいえ [false] - コネクション情報 以下のプロパティを使って接続を行います。
コネクション名connection-コネクションを使用 が「はい」の場合に接続先のAWSを指定します。 コネクションペインまたは管理コンソールにて作成されたAWS接続名を選択します。
コネクション情報group-コネクションを使用 が「いいえ」の場合に使用されるプロパティ群です。
アクセスキーstring入力&出力 アクセスキーを指定します。
サーバーがEC2インスタンス上にあり、アクセスキーを指定しない場合は、EC2インスタンスに設定されたIAMロールを使用します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
シークレットキーpassword入力&出力 シークレットキーを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
プロトコルchoice入力&出力 FSMCで設定したプロキシーサーバーを使用する場合、「プロキシの設定」で設定されたプロキシ情報の選択に使用します。
コネクションを使用 が「いいえ」の場合、かつプロキシ設定を使用 が「はい」の場合、この設定を参照します。
HTTP [http] - HTTPの設定を使用します
HTTPS [https] - HTTPSの設定を使用します
タイムアウト(秒)int入力&出力 リクエスト時およびコネクション接続時のソケットタイムアウト時間を秒単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
リクエストタイムアウト(分)int入力&出力 1回のリクエスト実行のタイムアウトまでの時間を分単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
リージョンchoice入力&出力 利用するAWSのリージョンを選択します。
選択肢にない場合はリージョンを表す文字列を入力することもできます。
例えば東京リージョンであれば ap-northeast-1を指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
AssumeRole ARNstring入力&出力 一時的な認証情報を使用するためにAssumeRoleのARNを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
一時的認証情報の有効期限(秒)int入力&出力 AssumeRole ARNで設定する一時的な認証情報の有効期限を秒単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
プロキシ設定を使用boolean入力&出力 管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
はい [true] - プロキシ設定を使用します。
いいえ [false] - プロキシ設定を使用しません。
テーブル名string入力&出力 アイテムを登録するテーブル名を指定します。
最大バッチ処理件数int入力&出力 バッチ処理で行う最大件数を指定します。
初期値は25件ですが、データ量の多いアイテムを追加する場合などに小さい値を設定します。
登録成功件数int   出力 登録に成功したアイテム数を返します。
登録失敗件数int   出力 登録に失敗したアイテム数を返します。
登録に失敗が多発する場合、書き込みスループットを増加させることを推奨します。

■トランザクション処理

コミット何もしません。
ロールバック何もしません。

■エラー処理

タイプパラメーターエラー処理フロー
へのストリーム
エラー
コード
説明
汎用 なし コンポーネントの入力ストリーム2必須のプロパティの項目が指定されていなかった場合
APIエラー「APIエラーの
パラメーター」

参照してください。
コンポーネントの入力ストリーム202認証に失敗した場合。
APIの実行でエラーコードAccessDeniedExceptionを受け取った場合が該当します。
203リクエストの頻度が多すぎる場合。
APIの実行でエラーコードProvisionedThroughputExceededExceptionを受け取った場合が該当します。
204テーブルの状態が無効な場合。
APIの実行でエラーコードResourceNotFoundExceptionを受け取った場合が該当します。
205AWSアクセスキーIDまたはシークレットキーが無効である場合。
APIの実行でエラーコードUnrecognizedClientExceptionを受け取った場合が該当します。
206必須パラメータが指定されていないなどの場合。
APIの実行でエラーコードValidationExceptionを受け取った場合が該当します。
207サイズ制限を超えた場合。
APIの実行でエラーコードItemCollectionSizeLimitExceededExceptionを受け取った場合が該当します。
201APIの実行で上記以外のエラーコードを受け取った場合。
接続エラー なし コンポーネントの入力ストリーム301接続に失敗した場合。

■APIエラーのパラメーター

APIエラーが発生したときに設定されるエラーのパラメーターです。

No.名前説明
1CodeAWSから取得したエラーコード。エラーの詳細につきましては、AWSのサイトを参照ください。
2MessageAWSから取得したエラーの内容。エラーの詳細につきましては、AWSのサイトを参照ください。

■制限事項

本コンポーネントはList型とMap型には対応していません。

■DynamoDB Browserの使い方

本コンポーネントをダブルクリックするか、右クリックメニューの「DynamoDB Browser」を実行すると、DynamoDB Browserが起動します。
DynamoDB Browserはテーブルプロパティを設定するために使用しますが、DynamoDBへの簡単な操作も行えます。

DynamoDB Browserの画面構成

①.DynamoDB構成情報ツリー
接続したDynamoDBのテーブル、インデックスをツリー構造で表示します。
ここで選択したテーブル、インデックスがプロパティへ設定されます。
  • ローカルセカンダリインデックス
    ローカルセカンダリインデックスの場合、名前に[Local]が追加されて表示されます。
  • グローバルセカンダリインデックス
    グローバルセカンダリインデックスの場合、名前に[Global]が追加されて表示されます。
②.選択内容
DynamoDB構成情報ツリーで選択した項目別に表示します。
  • Amazon DynamoDB
    • 「テーブル作成」ボタン
      クリックして表示されるダイアログに値を入力してテーブルを作成します。

      • テーブル名
        新規に作成するテーブル名を入力します。
      • ハッシュ属性名
        テーブルに設定するハッシュ属性名を入力し、型を選択します。
      • レンジ属性名
        テーブルに設定するレンジ属性名を入力し、型を選択します。
  • テーブル
    • ステータス
      選択しているテーブルのステータスを表示します。
    • ストレージ容量
      選択しているテーブルのストレージ容量を表示します。
    • ハッシュ属性名
      選択しているテーブルに設定されているハッシュ属性名を表示します。
      コンポーネントに「ハッシュ属性名」プロパティがある場合にこの値が設定されます。
      • 文字列
        文字列型の場合、名前に[S]が追加されて表示されます。
      • 数値
        数値型の場合、名前に[N]が追加されて表示されます。
      • バイナリ
        バイナリ型の場合、名前に[B]が追加されて表示されます。
    • レンジ属性名
      選択しているテーブルに設定されているレンジ属性名を表示します。
      コンポーネントに「レンジ属性名」プロパティがある場合にこの値が設定されます。
      • 文字列
        文字列型の場合、名前に[S]が追加されて表示されます。
      • 数値
        数値型の場合、名前に[N]が追加されて表示されます。
      • バイナリ
        バイナリ型の場合、名前に[B]が追加されて表示されます。
    • 読み取りスループットの合計
      選択しているテーブルに設定されている読み取りスループットの合計を表示します。
    • 書き込みスループットの合計
      選択しているテーブルに設定されている書き込みスループットの合計を表示します。
    • アイテム数
      選択しているテーブル内のアイテム数を表示します。
    • 「アイテム追加」ボタン
      クリックして表示されるダイアログにJSONを入力することで、選択しているテーブルへアイテムを追加します。
    • 「テーブル削除」ボタン
      選択しているテーブルを削除します。
  • インデックス
    • ステータス
      選択しているインデックスのステータスを表示します。
    • ストレージ容量
      選択しているインデックスのストレージ容量を表示します。
    • ハッシュ属性名
      選択しているインデックスに設定されているハッシュ属性名を表示します。
      コンポーネントに「ハッシュ属性名」プロパティがある場合にこの値が設定されます。
      • 文字列
        文字列型の場合、名前に[S]が追加されて表示されます。
      • 数値
        数値型の場合、名前に[N]が追加されて表示されます。
      • バイナリ
        バイナリ型の場合、名前に[B]が追加されて表示されます。
    • レンジ属性名
      選択しているインデックスに設定されているレンジ属性名を表示します。
      コンポーネントに「レンジ属性名」プロパティがある場合にこの値が設定されます。
      • 文字列
        文字列型の場合、名前に[S]が追加されて表示されます。
      • 数値
        数値型の場合、名前に[N]が追加されて表示されます。
      • バイナリ
        バイナリ型の場合、名前に[B]が追加されて表示されます。
    • 読み取りスループットの合計
      選択しているインデックスに設定されている読み取りスループットの合計を表示します。
    • 書き込みスループットの合計
      選択しているインデックスに設定されている書き込みスループットの合計を表示します。
    • アイテム数
      選択しているインデックス内のアイテム数を表示します。
    • 射影属性
      選択しているインデックスに射影属性が設定されている場合に、射影属性を表示します。
③.アイテム情報
  • アイテム
    DyanamoDB構成情報ツリーでテーブルを選択した場合に、テーブルに含まれるアイテムを取得して内容を表示します。
    アイテム取得時にはテーブルへのスキャンが行われます。
    • 1ページ最大取得数
      1回に取得する最大のアイテム数を数値で指定します。
      ※テーブル内に大量のアイテムが存在する場合やフィルターを設定する場合に、大きな値を設定すると動作が速くなる場合があります。
    • 「<<」ボタン
      ページ1へ移動します。
    • 「<」ボタン
      1ページ戻ります。
    • ページ n [アイテム m件]
      現在表示しているページ番号とページ内アイテム数を表示します。
    • 「>」ボタン
      1ページ進みます。
    • 条件式
      スキャン時にフィルターを1つだけ設定することができます。
      フィルターに使用する「属性名」「属性型」「比較演算子」を選択し、「値」を入力して「検索」ボタンをクリックします。
      フィルターの設定を変更するとページ情報はクリアされ、検索時には1ページ目が表示されます。
    • 「複製」ボタン
      選択したアイテムを複製して、新規にアイテムを追加します。
      ボタンをクリックするとダイアログが表示され、選択しているアイテムのJSONが表示されますので、JSONを編集してOKボタンをクリックします。
    • 「編集」ボタン
      選択したアイテムを編集します。
      ボタンをクリックするとダイアログが表示され、選択しているアイテムのJSONが表示されますので、JSONを編集してOKボタンをクリックします。
    • 「削除」ボタン
      選択したアイテムを削除します。
    • JSON
      選択したアイテムをJSON形式で表示します。
④.保存・キャンセル
  • 「保存」ボタン
    クリックするとDynamoDB構成情報ツリーで選択したテーブルをプロパティへ設定し「DynamoDB Browser」を終了します。
  • 「キャンセル」ボタン
    クリックすると内容を破棄して「DynamoDB Browser」を終了します。