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スクリプトからのレコード挿入、一回限りのデータ修正、テーブル間のデータ移行タスクのスクリプト作成。