DynamoDB UpdateItem Operation

UpdateItem -operasjonen i AWS DynamoDB hjelper databasesjefer med å endre eller redigere en eksisterende DynamoDB -tabell. Den lar deg oppdatere en eller flere attributter til et allerede eksisterende element eller legge til et nytt element til nytt element til en eksisterende tabell i databasen din. Spesielt kan du også bruke denne operasjonen til å erstatte et eksisterende attributtverdi-par.

Denne artikkelen diskuterer alt om UpdateItem -operasjonen. Du vil lære om operasjonens synopsis, parametere og hvordan du bruker den.

DynamoDB -synopsis og parametere

Som alle andre databaseoperasjoner, har DynamoDB UpdateItem -operasjonen en synopsis og relevante parametere. Python -synopsisen for denne operasjonen er som vist nedenfor. Det kan variere litt basert på programmeringsspråket ditt, men de fleste parametere bør forbli de samme.

UpdateItem (
Tablename = 'streng',
Nøkkel =
'String': 'S': 'String', 'n': 'String', 'B': B'bytes ',' SS ': [' String ', ...],' NS ': [' String ' ,…], 'Bs': [b'bytes ',…]
,
UpdateExpression = 'String',
ConditionExpression = 'String',
ExpressionAttributeValues ​​=
': String': 's': 'String', 'n': 'String', 'B': B'bytes ',' SS ': [' String ', ...],' ns ': [' String ',…],' Bs ': [b'bytes',…],
..
,
ReturnValues ​​= 'Ingen',
ReturnConsumedCapacity = 'Indexes',
ReturnItemCollectionMetrics = 'Størrelse'
)

For å bruke UpdateItem -operasjonen i Amazon DynamoDB, må du bruke syntaks ovenfor og gi flere parametere som spesifiserer elementet du har tenkt å oppdatere. Du må også spesifisere de nye attributtverdiene for den nye innstillingen.

Spesielt en typisk dynamoDB UpdateItem -kommando bør inneholde følgende parametere:

• Tablename: Navnet på DynamoDB -tabellen som inneholder varen du vil oppdatere.
• Nøkkel: Den primære tasten (partisjonstast/sorter -tasten) for elementet du trenger oppdatert. Forsikre deg om at du spesifiserer dette som et kart over attributtnavn/verdipar.
• Updatexpression: Et uttrykk som definerer attributtene du bør oppdatere og de nye verdiene for disse attributtene.

I tillegg kan det hende du må oppgi de valgfrie parametrene nedenfor. Disse parametrene er valgfrie og vil avhenge av miljøet ditt:

• Tilstanduttrykk: Denne valgfrie strengen spesifiserer en betingelse for UpdateItem -operasjonen. Oppdateringen vil bare lykkes hvis tilstanden evaluerer til sann.
• ExpressionAttributeNames: Det er kart over attributtnavn for plassholder ofte brukt i Updatexpression til de faktiske attributtnavnene som brukt i tabellen. Denne parameteren er bare nødvendig hvis noen av attributtnavnene i Updatexpression -funksjonene har reservert ord eller/og spesialtegn.
• ExpressionAttributeValues: Dette er et kart over plasseringsverdier som brukes i oppdateringsekspresjonen til de faktiske verdiene du har tenkt å bruke i oppdateringsoperasjonen. Det kommer til nytte hvis noen av attributtverdiene i oppdateringen er uttrykk eller variabler.
• Returverdi: Dette spesifiserer hvilken informasjon du trenger returnert etter suksessen med operasjonen. Standardverdien er ingen, noe som betyr at du ikke vil finne informasjon om svaret.
• ReturnConsumedCapacity: Dette spesifiserer hvor mye kapasitet som ble konsumert av oppdateringsoperasjonen. Standardverdien er ingen, noe som antyder at du ikke finner denne informasjonen i returverdien.
• ReturnItemCollectionMetrics: Dette spesifiserer antall varesamlinger som er berørt av DynamoDB UpdateItem -operasjonen. Standardverdien er ingen, noe som betyr at denne informasjonen ikke returneres.

Når du bruker AWS CLI, skal DynamoDB UpdateItem -syntaks se slik ut:

AWS DynamoDB Update-Item \
--tabell-navn tabell_navn \
--Key '"Key_name": "s": "key_value"' \
--Update-expression "set attributt_name =: val1, attributt_name2 =: val2" \
--Expression-Attribute-Values ​​'": val1": "s": "attributt_value", ": val2": "n": "attributt_value"' \
--Returverdier oppdatert_old

Eksempler på hvordan du bruker DynamoDB UpdateItem -operasjonen

DynamoDB UpdateItem -operasjonen er enkel å bruke. Og mens du er på det, må du sørge for at du inkluderer den primære nøkkelattributtet og Updatexpression.

Nedenfor er et eksempel på hvordan du kan bruke UpdateItem -operasjonen til å endre en DynamoDB -tabell:

AWS DynamoDB Update-Item \
--Bordnavn Musikk \
--Key '"Artist": "S": "Sauti Sol", "Songtitle": "S": "Feel My Love"' \
--Update-expression "sett albumtitle =: newval" \
--Expression-Attribute-Values ​​'": NewVal": "S": "Oppdatert albumtittel"' \
--Returverdier All_New

Resultatene for ovennevnte operasjon skal se slik ut:

Konklusjon

DynamoDB UpdateItem -operasjonen er enkel å bruke. Du kan bruke den til å endre elementer i eksisterende tabeller eller legge til elementer i et allerede eksisterende bord. Merk at du må spesifisere den primære nøkkelen og oppdateringsekspresjonen for at operasjonen skal lykkes. Vær også oppmerksom på miljøet ditt. Til slutt jobber DynamoDB UpdateItem -operasjonen, som resten av operasjonen, med AWS SDKS og AWS CLI.