Ovaj članak govori o svemu o operaciji UpdateItem. Naučit ćete o sinopsisu operacije, parametrima i kako se njime koristiti.
DynamoDB Sinopsis i parametri
Kao i svaka druga operacija baze podataka, operacija DynamoDB UpdateItem sadrži sinopsis i relevantne parametre. Python sinopsis za ovu operaciju prikazan je u nastavku. Može malo varirati ovisno o vašem programskom jeziku, ali većina parametara bi trebala ostati ista.
UpdateItem (
TableName = 'niz' ,
Ključ = {
'niz' : { 'S' : 'niz' , 'N' : 'niz' , 'B' : b 'bajtovi' , 'SS' : [ 'niz' , ... ] , 'NS' : [ 'niz' , ... ] , 'BS' : [ b 'bajtovi' , ... ] }
} ,
UpdateExpression = 'niz' ,
Izraz uvjeta = 'niz' ,
ExpressionAttributeValues = {
':niz' : { 'S' : 'niz' , 'N' : 'niz' , 'B' : b 'bajtovi' , 'SS' : [ 'niz' , ... ] , 'NS' : [ 'niz' , ... ] , 'BS' : [ b 'bajtovi' , ... ] } ,
...
} ,
Povratne vrijednosti = 'NIŠTA' ,
Vrati potrošeni kapacitet = 'INDEKSI' ,
ReturnItemCollectionMetrics = 'VELIČINA'
)
Da biste koristili operaciju UpdateItem u Amazon DynamoDB-u, morat ćete koristiti gornju sintaksu i dati nekoliko parametara koji određuju stavku koju namjeravate ažurirati. Također ćete morati navesti nove vrijednosti atributa za novu postavku.
Naime, tipična naredba DynamoDB UpdateItem trebala bi sadržavati sljedeće parametre:
- TableName : Naziv DynamoDB tablice koja sadrži stavku koju želite ažurirati.
- Ključ : Primarni ključ (ključ particije/ključ sortiranja) stavke koju trebate ažurirati. Provjerite jeste li ovo naveli kao mapu parova ime/vrijednost atributa.
- UpdateExpression : Izraz koji definira atribute koje trebate ažurirati i nove vrijednosti za te atribute.
Osim toga, možda ćete morati unijeti izborne parametre u nastavku. Ovi parametri nisu obavezni i ovisit će o vašem okruženju:
- Izraz uvjeta : Ovaj izborni niz specificira uvjet za operaciju updateitem. Ažuriranje će biti uspješno samo ako je uvjet procijenjen na True.
- ExpressionAttributeNames : To je mapa imena atributa rezerviranih mjesta koja se često koriste u UpdateExpression na stvarna imena atributa koja se koriste u tablici. Ovaj je parametar neophodan samo ako neki od naziva atributa u UpdateExpression sadrži rezervirane riječi i/ili posebne znakove.
- ExpressionAttributeValues : Ovo je mapa vrijednosti rezerviranih mjesta korištenih u UpdateExpression na stvarne vrijednosti koje namjeravate koristiti u operaciji ažuriranja. Dobro dolazi ako je bilo koja od vrijednosti atributa u UpdateExpression izraz ili varijabla.
- Povratne vrijednosti : Ovo određuje koje ćete informacije trebati vratiti nakon uspjeha operacije. Zadana vrijednost je NIJEDAN, što znači da nećete pronaći nikakve informacije o odgovoru.
- Vrati potrošeni kapacitet : Ovo određuje koliko je kapaciteta potrošeno operacijom ažuriranja. Njegova zadana vrijednost je NIJEDAN, što znači da nećete pronaći ovu informaciju u povratnoj vrijednosti.
- ReturnItemCollectionMetrics : Ovo specificira broj zbirki stavki na koje utječe DynamoDb updateitem operacija. Zadana vrijednost je NIJEDAN, što znači da se ova informacija ne vraća.
Kada koristite AWS CLI, DynamoDB UpdateItem sintaksa bi trebala izgledati ovako:
aws dynamodb update-item \--naziv-tablice TABLE_NAME \
--ključ '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--ažuriranje-izraza 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--vrijednosti-atributa-izraza '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--povratne-vrijednosti AŽURIRANO_STARO
Primjeri kako koristiti operaciju DynamoDB UpdateItem
Operacija DynamoDB UpdateItem jednostavna je za korištenje. I dok ste već kod toga, provjerite jeste li uključili atribut primarnog ključa i UpdateExpression.
Ispod je primjer kako možete koristiti operaciju UpdateItem za izmjenu DynamoDB tablice:
aws dynamodb update-item \--naziv-tablice Glazba, muzika \
--ključ '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--ažuriranje-izraza 'SET AlbumTitle = :newval' \
--vrijednosti-atributa-izraza '{':newval':{'S':'Ažurirani naslov albuma'}}' \
--povratne-vrijednosti SVE NOVO
Rezultati gornje operacije trebali bi izgledati ovako:
Zaključak
DynamoDB UpdateItem Operacija je jednostavna za korištenje. Možete ga koristiti za izmjenu stavki unutar postojećih tablica ili dodavanje stavki u već postojeću tablicu. Imajte na umu da morate navesti primarni ključ i UpdateExpression da bi operacija bila uspješna. Također, vodite računa o svom okruženju. Konačno, DynamoDB UpdateItem operacija, kao i ostale operacije, radi s AWS SDK-ovima i AWS CLI-jem.