Denne artikel diskuterer alt om UpdateItem-handlingen. Du vil lære om operationens synopsis, parametre og hvordan du bruger den.
DynamoDB synopsis og parametre
Som enhver anden databaseoperation har DynamoDB UpdateItem-operationen en synopsis og de relevante parametre. Python synopsis for denne operation er som vist nedenfor. Det kan variere lidt afhængigt af dit programmeringssprog, men de fleste parametre bør forblive de samme.
UpdateItem (
Tabelnavn = 'snor' ,
Nøgle = {
'snor' : { 'S' : 'snor' , 'N' : 'snor' , 'B' :b 'bytes' , 'SS' : [ 'snor' , ... ] , 'NS' : [ 'snor' , ... ] , 'BS' : [ b 'bytes' , ... ] }
} ,
UpdateExpression = 'snor' ,
Tilstandsudtryk = 'snor' ,
ExpressionAttributeValues = {
':snor' : { 'S' : 'snor' , 'N' : 'snor' , 'B' :b 'bytes' , 'SS' : [ 'snor' , ... ] , 'NS' : [ 'snor' , ... ] , 'BS' : [ b 'bytes' , ... ] } ,
...
} ,
Returværdier = 'INGEN' ,
ReturnerForbrugt Kapacitet = 'INDEKSER' ,
ReturnItemCollectionMetrics = 'STØRRELSE'
)
For at bruge UpdateItem-operationen i Amazon DynamoDB skal du bruge syntaksen ovenfor og angive flere parametre, der specificerer det element, du har til hensigt at opdatere. Du skal også angive de nye attributværdier for den nye indstilling.
Især skal en typisk DynamoDB UpdateItem-kommando indeholde følgende parametre:
- Tabelnavn : Navnet på DynamoDB-tabellen, der indeholder det element, du vil opdatere.
- Nøgle : Den primære nøgle (partitionsnøgle/sorteringsnøgle) for det element, du skal opdatere. Sørg for, at du angiver dette som et kort over attributnavn/værdi-par.
- UpdateExpression : Et udtryk, der definerer de attributter, du skal opdatere, og de nye værdier for disse attributter.
Derudover skal du muligvis angive de valgfrie parametre nedenfor. Disse parametre er valgfrie og afhænger af dit miljø:
- Tilstandsudtryk : Denne valgfri streng specificerer en betingelse for updateitem-handlingen. Opdateringen vil kun lykkes, hvis betingelsen evalueres til Sand.
- ExpressionAttributeNames : Det er kort over pladsholder-attributnavne, der ofte bruges i UpdateExpression, til de faktiske attributnavne, som bruges i tabellen. Denne parameter er kun nødvendig, hvis nogen af attributnavnene i UpdateExpression indeholder reserverede ord eller/og specialtegn.
- ExpressionAttributeValues : Dette er et kort over pladsholderværdier, der bruges i UpdateExpression, til de faktiske værdier, du har til hensigt at bruge i opdateringsoperationen. Det er praktisk, hvis nogen af attributværdierne i UpdateExpression er udtryk eller variable.
- Returværdier : Dette specificerer, hvilke oplysninger du skal have returneret, når operationen er vellykket. Standardværdien er NONE, hvilket betyder, at du ikke vil finde nogen information om svaret.
- ReturnerForbrugt Kapacitet : Dette angiver, hvor meget kapacitet der blev brugt af opdateringshandlingen. Dens standardværdi er NONE, hvilket betyder, at du ikke vil finde denne information i returværdien.
- ReturnItemCollectionMetrics : Dette angiver antallet af varesamlinger, der er påvirket af DynamoDb-opdateringselementet. Standardværdien er NONE, hvilket betyder, at disse oplysninger ikke returneres.
Når du bruger AWS CLI, skal DynamoDB UpdateItem-syntaksen se sådan ud:
aws dynamodb opdateringselement \--tabelnavn TABLE_NAME \
--nøgle '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--opdateringsudtryk 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--udtryk-attribut-værdier '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--afkastværdier OPDATERET_GAMMEL
Eksempler på, hvordan du bruger DynamoDB UpdateItem-handlingen
DynamoDB UpdateItem-operationen er nem at bruge. Og mens du er i gang, skal du sikre dig, at du inkluderer den primære nøgleattribut og UpdateExpression.
Nedenfor er et eksempel på, hvordan du kan bruge UpdateItem-operationen til at ændre en DynamoDB-tabel:
aws dynamodb opdateringselement \--tabelnavn Musik \
--nøgle '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Føl min kærlighed'}}' \
--opdateringsudtryk 'SET AlbumTitle = :newval' \
--udtryk-attribut-værdier '{':newval':{'S':'Opdateret albumtitel'}}' \
--afkastværdier HELT NY
Resultaterne for ovenstående operation skal se sådan ud:
Konklusion
DynamoDB UpdateItem Operation er nem at bruge. Du kan bruge den til at ændre elementer i eksisterende tabeller eller tilføje elementer til en allerede eksisterende tabel. Bemærk, at du skal angive den primære nøgle og UpdateExpression for at handlingen kan lykkes. Vær også opmærksom på dit miljø. Endelig fungerer DynamoDB UpdateItem Operation, ligesom resten af operationer, med AWS SDK'er og AWS CLI.