Tento článok popisuje všetko o operácii UpdateItem. Dozviete sa zhrnutie operácie, parametre a ako ju používať.
Synopsa a parametre DynamoDB
Ako každá iná databázová operácia, aj operácia DynamoDB UpdateItem obsahuje súhrn a príslušné parametre. Prehľad Pythonu pre túto operáciu je uvedený nižšie. Môže sa mierne líšiť v závislosti od vášho programovacieho jazyka, ale väčšina parametrov by mala zostať rovnaká.
UpdateItem (
TableName = 'reťazec' ,
kľúč = {
'reťazec' : { 'S' : 'reťazec' , 'N' : 'reťazec' , 'B' : b 'bajty' , 'SS' : [ 'reťazec' ,... ] , 'NS' : [ 'reťazec' ,... ] , 'BS' : [ b 'bajty' ,... ] }
} ,
Aktualizovať výraz = 'reťazec' ,
ConditionExpression = 'reťazec' ,
ExpressionAttributeValues = {
':string' : { 'S' : 'reťazec' , 'N' : 'reťazec' , 'B' : b 'bajty' , 'SS' : [ 'reťazec' ,... ] , 'NS' : [ 'reťazec' ,... ] , 'BS' : [ b 'bajty' ,... ] } ,
...
} ,
Návratové hodnoty = 'NONE' ,
ReturnConsumedCapacity = 'INDEXES' ,
ReturnItemCollectionMetrics = 'SIZE'
)
Ak chcete použiť operáciu UpdateItem v Amazon DynamoDB, budete musieť použiť vyššie uvedenú syntax a poskytnúť niekoľko parametrov, ktoré špecifikujú položku, ktorú chcete aktualizovať. Budete tiež musieť zadať nové hodnoty atribútov pre nové nastavenie.
Typický príkaz DynamoDB UpdateItem by mal obsahovať nasledujúce parametre:
- TableName : Názov tabuľky DynamoDB obsahujúcej položku, ktorú chcete aktualizovať.
- kľúč : Primárny kľúč (kľúč oddielu/triediaci kľúč) položky, ktorú potrebujete aktualizovať. Uistite sa, že ste to zadali ako mapu párov názov/hodnota atribútu.
- Aktualizovať výraz : Výraz, ktorý definuje atribúty, ktoré by ste mali aktualizovať, a nové hodnoty pre tieto atribúty.
Okrem toho možno budete musieť zadať voliteľné parametre uvedené nižšie. Tieto parametre sú voliteľné a budú závisieť od vášho prostredia:
- ConditionExpression : Tento voliteľný reťazec určuje podmienku pre operáciu updateitem. Aktualizácia bude úspešná iba vtedy, ak sa podmienka vyhodnotí ako True.
- ExpressionAttributeNames : Je to mapa zástupných názvov atribútov, ktoré sa často používajú v UpdateExpression, na skutočné názvy atribútov, ako sa používajú v tabuľke. Tento parameter je potrebný len vtedy, ak niektorý z názvov atribútov v UpdateExpression obsahuje vyhradené slová alebo/a špeciálne znaky.
- ExpressionAttributeValues : Toto je mapa zástupných hodnôt použitých v UpdateExpression k skutočným hodnotám, ktoré chcete použiť v operácii aktualizácie. Je to užitočné, ak niektorá z hodnôt atribútov v UpdateExpression sú výrazy alebo premenné.
- Návratové hodnoty : Toto špecifikuje, aké informácie budete potrebovať vrátiť po úspechu operácie. Predvolená hodnota je NONE, čo znamená, že v odpovedi nenájdete žiadne informácie.
- ReturnConsumedCapacity : Toto určuje, koľko kapacity bola spotrebovaná operáciou aktualizácie. Jeho predvolená hodnota je NONE, čo znamená, že túto informáciu nenájdete v návratovej hodnote.
- ReturnItemCollectionMetrics : Toto určuje počet kolekcií položiek ovplyvnených operáciou Updateitem DynamoDb. Predvolená hodnota je NONE, čo znamená, že tieto informácie sa nevracajú.
Pri používaní AWS CLI by syntax DynamoDB UpdateItem mala vyzerať takto:
aws dynamodb update-item \--názov-tabuľky TABLE_NAME \
--kľúč '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--update-expression 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--hodnoty-výrazu '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--návratné-hodnoty UPDATED_OLD
Príklady použitia operácie DynamoDB UpdateItem
Operácia DynamoDB UpdateItem sa ľahko používa. A pri tom sa uistite, že zahrniete atribút primárneho kľúča a UpdateExpression.
Nižšie je uvedený príklad, ako môžete použiť operáciu UpdateItem na úpravu tabuľky DynamoDB:
aws dynamodb update-item \--názov-tabuľky Hudba \
--kľúč '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--update-expression 'SET AlbumTitle = :newval' \
--hodnoty-výrazu '{':newval':{'S':'Aktualizovaný názov albumu'}}' \
--návratné-hodnoty VŠETKO NOVÉ
Výsledky vyššie uvedenej operácie by mali vyzerať takto:
Záver
Prevádzka DynamoDB UpdateItem sa ľahko používa. Môžete ho použiť na úpravu položiek v rámci existujúcich tabuliek alebo na pridávanie položiek do už existujúcej tabuľky. Aby bola operácia úspešná, musíte zadať primárny kľúč a UpdateExpression. Dávajte pozor aj na svoje prostredie. Nakoniec, operácia DynamoDB UpdateItem, rovnako ako ostatné operácie, funguje s AWS SDK a AWS CLI.