Tento článek popisuje vše o operaci UpdateItem. Dozvíte se o synopsi operace, parametrech a jak ji používat.
Synopse a parametry DynamoDB
Jako každá jiná databázová operace má operace DynamoDB UpdateItem synopse a příslušné parametry. Synopse Pythonu pro tuto operaci je uvedena níže. Může se mírně lišit v závislosti na vašem programovacím jazyce, ale většina parametrů by měla zůstat stejná.
UpdateItem (
Název_tabulky = 'tětiva' ,
Klíč = {
'tětiva' : { 'S' : 'tětiva' , 'N' : 'tětiva' , 'B' : b 'bajty' , 'SS' : [ 'tětiva' ,... ] , 'NS' : [ 'tětiva' ,... ] , 'BS' : [ b 'bajty' ,... ] }
} ,
Aktualizovat výraz = 'tětiva' ,
ConditionExpression = 'tětiva' ,
ExpressionAttributeValues = {
':tětiva' : { 'S' : 'tětiva' , 'N' : 'tětiva' , 'B' : b 'bajty' , 'SS' : [ 'tětiva' ,... ] , 'NS' : [ 'tětiva' ,... ] , 'BS' : [ b 'bajty' ,... ] } ,
...
} ,
Návratové hodnoty = 'ŽÁDNÝ' ,
ReturnConsumedCapacity = 'INDEXES' ,
ReturnItemCollectionMetrics = 'VELIKOST'
)
Chcete-li použít operaci UpdateItem v Amazon DynamoDB, budete muset použít výše uvedenou syntaxi a zadat několik parametrů, které určují položku, kterou chcete aktualizovat. Budete také muset zadat nové hodnoty atributů pro nové nastavení.
Typický příkaz DynamoDB UpdateItem by měl obsahovat následující parametry:
- Název_tabulky : Název tabulky DynamoDB obsahující položku, kterou chcete aktualizovat.
- Klíč : Primární klíč (klíč oddílu/třídicí klíč) položky, kterou potřebujete aktualizovat. Ujistěte se, že to zadáte jako mapu párů název/hodnota atributu.
- Aktualizovat výraz : Výraz, který definuje atributy, které byste měli aktualizovat, a nové hodnoty pro tyto atributy.
Dále může být nutné zadat volitelné parametry níže. Tyto parametry jsou volitelné a budou záviset na vašem prostředí:
- ConditionExpression : Tento volitelný řetězec určuje podmínku pro operaci updateitem. Aktualizace bude úspěšná pouze v případě, že se podmínka vyhodnotí jako True.
- ExpressionAttributeNames : Je to mapa zástupných názvů atributů často používaných v UpdateExpression ke skutečným názvům atributů, jak jsou použity v tabulce. Tento parametr je nutný pouze v případě, že některý z názvů atributů v UpdateExpression obsahuje vyhrazená slova nebo/a speciální znaky.
- ExpressionAttributeValues : Toto je mapa zástupných hodnot použitých v UpdateExpression ke skutečným hodnotám, které hodláte použít v operaci aktualizace. Je to užitečné, pokud jsou některé z hodnot atributů v UpdateExpression výrazy nebo proměnné.
- Návratové hodnoty : Toto určuje, jaké informace budete potřebovat vrátit po úspěchu operace. Výchozí hodnota je NONE, což znamená, že v odpovědi nenajdete žádné informace.
- ReturnConsumedCapacity : Určuje, kolik kapacity byla spotřebována operací aktualizace. Jeho výchozí hodnota je NONE, což znamená, že tuto informaci v vrácené hodnotě nenajdete.
- ReturnItemCollectionMetrics : Toto určuje počet kolekcí položek ovlivněných operací Updateitem DynamoDb. Výchozí hodnota je NONE, což znamená, že tyto informace nejsou vráceny.
Při použití AWS CLI by syntaxe DynamoDB UpdateItem měla vypadat takto:
aws dynamodb update-item \--název-tabulky TABLE_NAME \
--klíč '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--update-expression 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--výraz-atribut-hodnoty '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--návratné-hodnoty UPDATED_OLD
Příklady použití operace DynamoDB UpdateItem
Operace DynamoDB UpdateItem se snadno používá. A přitom se ujistěte, že zahrnete atribut primárního klíče a UpdateExpression.
Níže je příklad toho, jak můžete použít operaci UpdateItem k úpravě tabulky DynamoDB:
aws dynamodb update-item \--název-tabulky Hudba \
--klíč '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--update-expression 'SET AlbumTitle = :newval' \
--výraz-atribut-hodnoty '{':newval':{'S':'Aktualizovaný název alba'}}' \
--návratné-hodnoty VŠECHNO NOVÉ
Výsledky výše uvedené operace by měly vypadat takto:
Závěr
Operace DynamoDB UpdateItem se snadno používá. Můžete jej použít k úpravě položek v existujících tabulkách nebo k přidání položek do již existující tabulky. Aby byla operace úspěšná, musíte zadat primární klíč a UpdateExpression. Buďte také ohleduplní ke svému prostředí. A konečně, operace DynamoDB UpdateItem, stejně jako ostatní operace, funguje s AWS SDK a AWS CLI.