この記事では、UpdateItem 操作に関するすべてについて説明します。操作の概要、パラメーター、およびその使用方法について学習します。
DynamoDB の概要とパラメータ
他のすべてのデータベース操作と同様に、DynamoDB の UpdateItem 操作には、概要と関連するパラメーターがあります。この操作の Python の概要は次のとおりです。プログラミング言語によって多少異なる場合がありますが、ほとんどのパラメーターは同じままです。
UpdateItem (
テーブル名 = 'ストリング' 、
鍵 = {
'ストリング' : { 'S' : 'ストリング' 、 「ん」 : 'ストリング' 、 'B' : b 「バイト」 、 'SS' : [ 'ストリング' 、... ] 、 'NS' : [ 'ストリング' 、... ] 、 「BS」 : [ b 「バイト」 、... ] }
} 、
更新式 = 'ストリング' 、
条件式 = 'ストリング' 、
ExpressionAttributeValues = {
'：ストリング' : { 'S' : 'ストリング' 、 「ん」 : 'ストリング' 、 'B' : b 「バイト」 、 'SS' : [ 'ストリング' 、... ] 、 'NS' : [ 'ストリング' 、... ] 、 「BS」 : [ b 「バイト」 、... ] } 、
...
} 、
戻り値 = '無し' 、
ReturnConsumedCapacity = 「インデックス」 、
ReturnItemCollectionMetrics = 'サイズ'
)
Amazon DynamoDB で UpdateItem オペレーションを使用するには、上記の構文を使用し、更新する項目を指定するいくつかのパラメーターを指定する必要があります。また、新しい設定の新しい属性値を指定する必要があります。
特に、典型的な DynamoDB UpdateItem コマンドには、次のパラメーターが含まれている必要があります。
- テーブル名 : 更新するアイテムを含む DynamoDB テーブルの名前。
- 鍵 : 更新が必要な項目の主キー (パーティション キー/ソート キー)。これは、属性の名前と値のペアのマップとして指定してください。
- 更新式 : 更新する必要がある属性と、それらの属性の新しい値を定義する式。
さらに、以下のオプションのパラメーターを指定する必要がある場合があります。これらのパラメーターはオプションであり、環境によって異なります。
- 条件式 : このオプションの文字列は、updateitem 操作の条件を指定します。更新は、条件が True と評価された場合にのみ成功します。
- ExpressionAttributeNames : UpdateExpression でよく使用されるプレースホルダー属性名を、テーブルで使用される実際の属性名にマップしたものです。このパラメーターは、UpdateExpression の属性名のいずれかに予約語や特殊文字が含まれている場合にのみ必要です。
- ExpressionAttributeValues : これは、UpdateExpression で使用されるプレースホルダー値から、更新操作で使用する予定の実際の値へのマップです。 UpdateExpression の属性値のいずれかが式または変数である場合に便利です。
- 戻り値 : これは、操作が成功したときに返される必要のある情報を指定します。デフォルト値は NONE で、応答に関する情報が見つからないことを意味します。
- ReturnConsumedCapacity : これは、更新操作によって消費された容量を示します。デフォルト値は NONE で、戻り値にこの情報が含まれていないことを意味します。
- ReturnItemCollectionMetrics : DynamoDb updateitem オペレーションの影響を受ける項目コレクションの数を指定します。デフォルト値は NONE です。これは、この情報が返されないことを意味します。
AWS CLI を使用する場合、DynamoDB UpdateItem 構文は次のようになります。
aws dynamodb update-item \--テーブル名 テーブル名 \
- 鍵 '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--更新式 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--式属性値 '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--戻り値 UPDATED_OLD
DynamoDB UpdateItem オペレーションの使用方法の例
DynamoDB UpdateItem 操作は使いやすいです。その際、必ず主キー属性と UpdateExpression を含めてください。
以下は、UpdateItem オペレーションを使用して DynamoDB テーブルを変更する方法の例です。
aws dynamodb update-item \--テーブル名 音楽 \
- 鍵 '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--更新式 'SET AlbumTitle = :newval' \
--式属性値 '{':newval':{'S':'更新されたアルバムのタイトル'}}' \
--戻り値 最新の
上記の操作の結果は次のようになります。
結論
DynamoDB UpdateItem 操作は簡単です。これを使用して、既存のテーブル内のアイテムを変更したり、既存のテーブルにアイテムを追加したりできます。操作を成功させるには、主キーと UpdateExpression を指定する必要があることに注意してください。また、あなたの環境に注意してください。最後に、DynamoDB UpdateItem オペレーションは、他のオペレーションと同様に、AWS SDK と AWS CLI で動作します。