AWS DynamoDB: テーブルにアイテムを追加する

aws dynamodb put-itemを使用して、DynamoDB JSON形式、条件付き書き込み、戻り値でDynamoDBにアイテムを挿入または置換します。

DynamoDB Operations

詳細な説明

DynamoDBへのアイテム追加

aws dynamodb put-itemコマンドは、DynamoDBテーブルに新しいアイテムを作成するか、既存のアイテムを置換します。アイテムは型記述子を含むDynamoDBのJSON形式で指定します。

基本的なPut Item

aws dynamodb put-item \
  --table-name Users \
  --item '{
    "userId": {"S": "user-001"},
    "name": {"S": "Alice Johnson"},
    "email": {"S": "alice@example.com"},
    "age": {"N": "28"},
    "active": {"BOOL": true}
  }'

DynamoDB JSON型記述子

キー
String S {"S": "hello"}
Number N {"N": "42"}(常に文字列)
Boolean BOOL {"BOOL": true}
Null NULL {"NULL": true}
List L {"L": [{"S": "a"}, {"N": "1"}]}
Map M {"M": {"key": {"S": "val"}}}

条件付きPut(上書き防止)

aws dynamodb put-item \
  --table-name Users \
  --item '{"userId": {"S": "user-001"}, "name": {"S": "Alice"}}' \
  --condition-expression "attribute_not_exists(userId)"

アイテムが既に存在する場合、ConditionalCheckFailedExceptionで失敗します。

ユースケース

DynamoDBテーブルへのテストデータのシード、CLIスクリプトからのレコード挿入、一回限りのデータ修正、テーブル間のデータ移行タスクのスクリプト作成。

試してみる — AWS CLI Command Builder

フルツールを開く