Ta članek obravnava vse o operaciji UpdateItem. Spoznali boste sinopsis operacije, parametre in kako jo uporabljati.
Sinopsis in parametri DynamoDB
Kot vsaka druga operacija baze podatkov ima tudi operacija DynamoDB UpdateItem povzetek in ustrezne parametre. Sinopsis Pythona za to operacijo je prikazan spodaj. Lahko se nekoliko razlikuje glede na vaš programski jezik, vendar mora večina parametrov ostati enaka.
UpdateItem (
TableName = 'vrvica' ,
Ključ = {
'vrvica' : { 'S' : 'vrvica' , 'N' : 'vrvica' , 'B' : b 'bajti' , 'SS' : [ 'vrvica' , ... ] , 'NS' : [ 'vrvica' , ... ] , 'BS' : [ b 'bajti' , ... ] }
} ,
UpdateExpression = 'vrvica' ,
ConditionExpression = 'vrvica' ,
ExpressionAttributeValues = {
':vrvica' : { 'S' : 'vrvica' , 'N' : 'vrvica' , 'B' : b 'bajti' , 'SS' : [ 'vrvica' , ... ] , 'NS' : [ 'vrvica' , ... ] , 'BS' : [ b 'bajti' , ... ] } ,
...
} ,
Povratne vrednosti = 'BEZ' ,
ReturnConsumedCapacity = 'INDEKSI' ,
ReturnItemCollectionMetrics = 'VELIKOSTI'
)
Če želite uporabiti operacijo UpdateItem v Amazon DynamoDB, boste morali uporabiti zgornjo sintakso in podati več parametrov, ki določajo postavko, ki jo nameravate posodobiti. Določiti boste morali tudi nove vrednosti atributov za novo nastavitev.
Tipičen ukaz DynamoDB UpdateItem mora vsebovati naslednje parametre:
- TableName : ime tabele DynamoDB, ki vsebuje element, ki ga želite posodobiti.
- Ključ : Primarni ključ (particijski ključ/razvrstitveni ključ) predmeta, ki ga želite posodobiti. Prepričajte se, da ste to določili kot zemljevid parov ime/vrednost atributa.
- UpdateExpression : izraz, ki definira atribute, ki jih morate posodobiti, in nove vrednosti za te atribute.
Poleg tega boste morda morali podati izbirne parametre spodaj. Ti parametri so neobvezni in so odvisni od vašega okolja:
- ConditionExpression : Ta izbirni niz podaja pogoj za operacijo updateitem. Posodobitev bo uspešna samo, če je pogoj ocenjen na True.
- ExpressionAttributeNames : Je preslikava imen atributov nadomestnih mest, ki se pogosto uporabljajo v UpdateExpression, na dejanska imena atributov, kot so uporabljena v tabeli. Ta parameter je potreben samo, če katero koli ime atributa v UpdateExpression vsebuje rezervirane besede ali/ali posebne znake.
- ExpressionAttributeValues : To je preslikava vrednosti nadomestnih znakov, uporabljenih v UpdateExpression, na dejanske vrednosti, ki jih nameravate uporabiti v operaciji posodabljanja. Pride prav, če je katera od vrednosti atributa v UpdateExpression izraz ali spremenljivka.
- Povratne vrednosti : To določa, katere informacije boste potrebovali vrnjene po uspehu operacije. Privzeta vrednost je NONE, kar pomeni, da v odgovoru ne boste našli nobenih informacij.
- ReturnConsumedCapacity : To določa, koliko kapacitete je porabila operacija posodobitve. Njegova privzeta vrednost je NONE, kar pomeni, da te informacije ne boste našli v vrnjeni vrednosti.
- ReturnItemCollectionMetrics : To določa število zbirk elementov, na katere vpliva operacija posodobitve predmeta DynamoDb. Privzeta vrednost je NONE, kar pomeni, da te informacije niso vrnjene.
Pri uporabi AWS CLI bi morala sintaksa DynamoDB UpdateItem izgledati takole:
aws dynamodb update-item \--ime-tabele TABLE_NAME \
--ključ '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--posodobitev-izraza 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--expression-atribut-values '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--povratne-vrednosti POSODOBLJENO_STARO
Primeri uporabe operacije DynamoDB UpdateItem
Operacija DynamoDB UpdateItem je enostavna za uporabo. In ko ste že pri tem, zagotovite, da vključite atribut primarnega ključa in UpdateExpression.
Spodaj je primer, kako lahko uporabite operacijo UpdateItem za spreminjanje tabele DynamoDB:
aws dynamodb update-item \--ime-tabele Glasba \
--ključ '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--posodobitev-izraza 'SET AlbumTitle = :newval' \
--expression-atribut-values '{':newval':{'S':'Posodobljeni naslov albuma'}}' \
--povratne-vrednosti VSE_NOVO
Rezultati zgornje operacije bi morali izgledati takole:
Zaključek
Operacija DynamoDB UpdateItem je enostavna za uporabo. Uporabite ga lahko za spreminjanje elementov znotraj obstoječih tabel ali dodajanje elementov v že obstoječo tabelo. Upoštevajte, da morate podati primarni ključ in UpdateExpression, da bo operacija uspešna. Prav tako bodite pozorni na svoje okolje. Nazadnje, operacija DynamoDB UpdateItem, tako kot ostale operacije, deluje s SDK-ji AWS in CLI AWS.