En aquest article s'explica tot sobre l'operació UpdateItem. Aprendràs la sinopsi de l'operació, els paràmetres i com utilitzar-la.
Sinopsi i paràmetres de DynamoDB
Com qualsevol altra operació de base de dades, l'operació DynamoDB UpdateItem inclou una sinopsi i els paràmetres rellevants. La sinopsi de Python per a aquesta operació és la que es mostra a continuació. Pot variar lleugerament en funció del vostre llenguatge de programació, però la majoria dels paràmetres haurien de romandre iguals.
UpdateItem (
NomTaula = 'cadena' ,
clau = {
'cadena' : { 'S' : 'cadena' , 'N' : 'cadena' , 'B' : b 'bytes' , 'SS' : [ 'cadena' , ... ] , 'NS' : [ 'cadena' , ... ] , 'BS' : [ b 'bytes' , ... ] }
} ,
UpdateExpression = 'cadena' ,
ConditionExpression = 'cadena' ,
ExpressionAttributeValues = {
':cadena' : { 'S' : 'cadena' , 'N' : 'cadena' , 'B' : b 'bytes' , 'SS' : [ 'cadena' , ... ] , 'NS' : [ 'cadena' , ... ] , 'BS' : [ b 'bytes' , ... ] } ,
...
} ,
Valors de retorn = 'cap' ,
Capacitat de retorn consumida = 'ÍNDEXS' ,
ReturnItemCollectionMetrics = 'MISURA'
)
Per utilitzar l'operació UpdateItem a Amazon DynamoDB, haureu d'utilitzar la sintaxi anterior i proporcionar diversos paràmetres que especifiquen l'element que voleu actualitzar. També haureu d'especificar els nous valors d'atribut per a la nova configuració.
En particular, una ordre típica de DynamoDB UpdateItem hauria de contenir els paràmetres següents:
- NomTaula : el nom de la taula DynamoDB que conté l'element que voleu actualitzar.
- clau : la clau primària (clau de partició/clau d'ordenació) de l'element que necessiteu actualitzar. Assegureu-vos d'especificar-ho com a mapa de parells nom/valor d'atribut.
- UpdateExpression : una expressió que defineix els atributs que hauríeu d'actualitzar i els nous valors d'aquests atributs.
A més, és possible que hàgiu de proporcionar els paràmetres opcionals a continuació. Aquests paràmetres són opcionals i dependran del vostre entorn:
- ConditionExpression : Aquesta cadena opcional especifica una condició per a l'operació updateitem. L'actualització només tindrà èxit si la condició s'avalua com a True.
- ExpressionAttributeNames : és un mapa de noms d'atributs de marcador de posició que s'utilitzen sovint a UpdateExpression amb els noms d'atributs reals tal com s'utilitzen a la taula. Aquest paràmetre només és necessari si algun dels noms d'atribut de l'Expression d'actualització inclou paraules reservades o caràcters especials.
- ExpressionAttributeValues : Aquest és un mapa dels valors de marcador de posició utilitzats a UpdateExpression amb els valors reals que voleu utilitzar en l'operació d'actualització. És útil si algun dels valors d'atribut de l'Expression d'actualització és expressions o variables.
- Valors de retorn : Això especifica quina informació necessitareu tornar quan l'operació tingui èxit. El valor predeterminat és NONE, és a dir, no trobareu cap informació sobre la resposta.
- Capacitat de retorn consumida : Especifica quanta capacitat va consumir l'operació d'actualització. El seu valor per defecte és NINGÚ, la qual cosa implica que no trobareu aquesta informació al valor de retorn.
- ReturnItemCollectionMetrics : Especifica el nombre de col·leccions d'elements afectades per l'operació d'actualització de DynamoDb. El valor per defecte és NONE, la qual cosa significa que aquesta informació no es retorna.
Quan utilitzeu AWS CLI, la sintaxi de DynamoDB UpdateItem hauria de tenir aquest aspecte:
element d'actualització de aws dynamodb \--nom-taula TABLE_NAME \
--clau '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--actualització-expressió 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--expressió-valors-atributs '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--valors-retorn ACTUALITZAT_OLD
Exemples sobre com utilitzar l'operació DynamoDB UpdateItem
L'operació DynamoDB UpdateItem és fàcil d'utilitzar. I mentre hi feu, assegureu-vos d'incloure l'atribut de clau primària i l'Expression d'actualització.
A continuació es mostra un exemple de com podeu utilitzar l'operació UpdateItem per modificar una taula DynamoDB:
element d'actualització de aws dynamodb \--nom-taula Música \
--clau '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--actualització-expressió 'SET AlbumTitle = :newval' \
--expressió-valors-atributs '{':newval':{'S':'Títol de l'àlbum actualitzat'}}' \
--valors-retorn TOT NOU
Els resultats de l'operació anterior haurien de ser així:
Conclusió
El funcionament de DynamoDB UpdateItem és fàcil d'utilitzar. Podeu utilitzar-lo per modificar elements dins de taules existents o afegir elements a una taula ja existent. Tingueu en compte que heu d'especificar la clau primària i UpdateExpression perquè l'operació tingui èxit. A més, tingueu en compte el vostre entorn. Finalment, l'operació DynamoDB UpdateItem, com la resta d'operacions, funciona amb AWS SDK i AWS CLI.