Acest articol discută totul despre operațiunea UpdateItem. Veți afla despre rezumatul operațiunii, parametrii și cum să o utilizați.
Sinopsis și parametri DynamoDB
Ca orice altă operațiune de bază de date, operațiunea DynamoDB UpdateItem prezintă un rezumat și parametrii relevanți. Sinopsisul Python pentru această operațiune este prezentat mai jos. Poate varia ușor în funcție de limbajul dvs. de programare, dar majoritatea parametrilor ar trebui să rămână la fel.
UpdateItem (
TableName = 'şir' ,
Cheie = {
'şir' : { „S” : 'şir' , 'N' : 'şir' , „B” : b „octeți” , 'SS' : [ 'şir' ,... ] , „NS” : [ 'şir' ,... ] , „BS” : [ b „octeți” ,... ] }
} ,
UpdateExpression = 'şir' ,
ConditionExpression = 'şir' ,
ExpressionAttributeValues = {
':şir' : { „S” : 'şir' , 'N' : 'şir' , „B” : b „octeți” , 'SS' : [ 'şir' ,... ] , „NS” : [ 'şir' ,... ] , „BS” : [ b „octeți” ,... ] } ,
...
} ,
Valori returnate = 'NICI UNUL' ,
ReturnConsumedCapacity = „INDEXI” ,
ReturnItemCollectionMetrics = 'MĂRIMEA'
)
Pentru a utiliza operațiunea UpdateItem în Amazon DynamoDB, va trebui să utilizați sintaxa de mai sus și să furnizați mai mulți parametri care specifică elementul pe care intenționați să îl actualizați. De asemenea, va trebui să specificați noile valori ale atributelor pentru noua setare.
În special, o comandă tipică DynamoDB UpdateItem ar trebui să conțină următorii parametri:
- TableName : Numele tabelului DynamoDB care conține elementul pe care doriți să îl actualizați.
- Cheie : cheia primară (cheia de partiție/cheia de sortare) a articolului de care trebuie actualizat. Asigurați-vă că specificați acest lucru ca hartă a perechilor nume/valoare de atribut.
- UpdateExpression : O expresie care definește atributele pe care ar trebui să le actualizați și noile valori pentru acele atribute.
În plus, poate fi necesar să furnizați parametrii opționali de mai jos. Acești parametri sunt opționali și vor depinde de mediul dvs.:
- ConditionExpression : Acest șir opțional specifică o condiție pentru operația updateitem. Actualizarea va avea succes numai dacă condiția este evaluată la True.
- ExpressionAttributeNames : este o hartă a numelor de atribute de substituent utilizate adesea în UpdateExpression cu numele de atribute reale, așa cum sunt utilizate în tabel. Acest parametru este necesar numai dacă oricare dintre numele atributelor din UpdateExpression prezintă cuvinte rezervate sau/și caractere speciale.
- ExpressionAttributeValues : Aceasta este o hartă a valorilor substituenților utilizate în UpdateExpression cu valorile reale pe care intenționați să le utilizați în operația de actualizare. Este util dacă oricare dintre valorile atributelor din UpdateExpression sunt expresii sau variabile.
- Valori returnate : Aceasta specifică de ce informații veți avea nevoie să returnați după succesul operațiunii. Valoarea implicită este NONE, ceea ce înseamnă că nu veți găsi nicio informație despre răspuns.
- ReturnConsumedCapacity : Aceasta specifică cât de multă capacitate a fost consumată de operația de actualizare. Valoarea sa implicită este NIMIC, ceea ce înseamnă că nu veți găsi aceste informații în valoarea returnată.
- ReturnItemCollectionMetrics : Aceasta specifică numărul de colecții de articole afectate de operațiunea de actualizare DynamoDb. Valoarea implicită este NONE, ceea ce înseamnă că această informație nu este returnată.
Când utilizați AWS CLI, sintaxa DynamoDB UpdateItem ar trebui să arate astfel:
element de actualizare aws dynamodb \--nume-tabel TABLE_NAME \
--cheie „{ „KEY_NAME”: {“S”: „KEY_VALUE” } }” \
--actualizare-expresie „SETAT ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2” \
--expression-atribut-valori '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--valori-retur UPDATED_OLD
Exemple despre cum să utilizați operația DynamoDB UpdateItem
Operația DynamoDB UpdateItem este ușor de utilizat. Și, în timp ce sunteți, asigurați-vă că includeți atributul cheii primare și UpdateExpression.
Mai jos este un exemplu despre cum puteți utiliza operația UpdateItem pentru a modifica un tabel DynamoDB:
element de actualizare aws dynamodb \--nume-tabel Muzică \
--cheie '{ 'Artist': {'S': 'Sauți Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--actualizare-expresie „SET AlbumTitle = :newval” \
--expression-atribut-valori '{':newval':{'S':'Titlul albumului actualizat'}}' \
--valori-retur TOTUL NOU
Rezultatele operației de mai sus ar trebui să arate astfel:
Concluzie
Operațiunea DynamoDB UpdateItem este ușor de utilizat. Îl puteți folosi pentru a modifica elemente din tabelele existente sau pentru a adăuga elemente la un tabel deja existent. Rețineți că trebuie să specificați cheia primară și UpdateExpression pentru ca operația să aibă succes. De asemenea, fii atent la mediul înconjurător. În cele din urmă, operațiunea DynamoDB UpdateItem, ca și restul operațiunilor, funcționează cu AWS SDK-uri și AWS CLI.