DynamoDB PUITEM -operasjonsoversikt, syntaks og eksempler

DynamoDB PutItem -operasjonen hjelper til med å lage et nytt element eller erstatte et eksisterende element i en DynamoDB -tabell. Det hjelper bemerkelsesverdig til å opprettholde konsistensen i tabellene dine ved å sikre at du enkelt lagrer dataene dine på en organisert måte.

Når du bruker denne kommandoen eller noen av dens derivater med primærnøkler som er de samme som for en allerede eksisterende vare, erstatter den varen. På den annen side kan du bruke den til å legge til et element ved å utnytte den betingede put -operasjonen.

Denne opplæringen diskuterer alt du bør vite om DynamoDB. Vi vil gå gjennom en kort oversikt, syntaks og noen få brukssaker.

La oss komme i gang!

Dynamodb putitem kommando syntaks

Ideelt sett kan du bruke DynamoDB PutItem -operasjonen med noen av AWS SDK -ene eller med AWS CLI API -samtale. Uansett må du oppgi navnet på tabellen du vil lage et tilleggsutstyr eller erstatning, og en ordbok med attributtnavn-verdipar som definerer varens egenskaper.

Det kan også hende du må spesifisere de valgfrie parametrene som varens primære nøkkelverdier, de forventede verdiene for visse/spesifikke attributter, og returverdiene du forventer av DynamoDB -responsen.

Hvis du spesifiserer en attributtverdi som ikke eksisterer i det spesifiserte tabellens skjema, oppretter DynamoDB attributtet for deg. Imidlertid, hvis du prøver å oppdatere et attributt som ikke er tillatt av tabellens skjema, mislykkes operasjonen.

Putitem -operasjonen skiller seg ut som en idempotent operasjon, noe som antyder at flere identiske forespørsler har samme effekt som en enkelt forespørsel. Dette kan være nyttig når du vil sikre at du oppretter, oppdaterer eller erstatter et element i en DynamoDB -tabell selv om operasjonen er på nytt flere ganger.

Putitem-operasjonen returnerer en ordbok med attributtnavnverdipar, som representerer varen slik det vises i tabellen etter at operasjonen er fullført. Dette kan være nyttig for feilsøking eller for å bekrefte at varen er lagret riktig.

en. Bruke AWS CLI for DynamoDB PutItem -drift

AWS CLI -syntaks for DynamoDB PutItem -operasjonen er som følger:

aws dynamodb put-element \
--Tabell-navn My_Table \
--element '"pk": "s": "a12345b", "sk": "s": "x67890y", "attr1": "n": "c123d", "attr2": "S": "ABC" '

Dette eksemplet legger til et nytt element til "my_table”Tabell som har primære nøkkelattributter - pk og SK. Verdien for de primære attributtene, PK og SK, er henholdsvis X12345Y og A67890B. Elementet har også flere attributter som ATTR1 med en numerisk verdi av C123D og ATTR2 som inneholder en strengverdi av ABC.

Du kan bruke alternativet -tilbakeholdsverdier for å spesifisere verdiene du vil at DynamoDB skal returnere i svaret.

For å returnere de gamle attributtverdiene for elementet som erstattes, kan du for eksempel bruke følgende syntaks:

aws dynamodb put-element \
--Tabell-navn My_Table \
--element '"pk": "s": "a12345b", "sk": "s": "x67890y", "attr1": "n": "t456u", "attr2": "S": "def" '\
--Returverdier All_old

I forrige eksempel erstatter PutItem -operasjonen varen i my_table tabell med de nye attributtverdiene som er spesifisert i -punkt parameter. De -Returverdier Alternativet spesifiserer at DynamoDB -responsen skal returnere de gamle attributtverdiene for varen.

b. Dynamodb PutItem -operasjon ved bruk av Python (BOTO3)

Når du bruker Python, skal syntaks se slik ut:

Importer BOTO3
# Opprett en DynamoDB -klient
dynamodb = boto3.klient ('dynamodb')
# Angi tabellnavnet og vareattributtene
tabell_name = 'my_table'
element =
'pk': 's': 'x12345y',
'SK': 'S': 'A67890B',
'attr1': 'n': '123',
'attr2': 's': 'abc'

# Ring PutItem -operasjonen
Response = Dynamodb.put_item (tablename = table_name, item = item)
# Skriv ut svaret
trykk (svar)

Hvordan bruke DynamoDB PutItem -operasjonen med returverdiparameteren

Du kan også bruke parameteren ReturnValues ​​for å spesifisere hvilke verdier du vil bli returnert i DynamoDB -responsen. De mulige verdiene for parameteren ReturnValues ​​inkluderer følgende:

• INGEN: Dette er standardverdien og returnerer ingen verdier.
• All_old: Du kan bruke dette når du bytter ut et element. Attributtene til varen du vil erstatte kommer tilbake i svaret.
• Oppdatert_old: Hvis elementet som erstattes har noen attributtverdier som allerede er oppdatert, inneholder responsen de gamle verdiene.
• HELT NY: Hvis elementet som byttes ut har noen attributter, inneholder responsen deres verdier.
• Oppdatert_new: Hvis elementet som erstattes har noen attributtverdier som ble oppdatert, inneholder responsen de nye attributtene.

Spesielt forbruker Putitem -operasjonen skrivekapasitetsenhetene fra bordets leverte skrivekapasitet. Hvis du overskrider tabellens leverte skrivekapasitet, vil operasjonen mest sannsynlig mislykkes og returnere en bestemmelse om utstråling.

Konklusjon

Totalt sett er DynamoDB PutItem -operasjonen en kraftig måte å legge til eller oppdatere elementene i en DynamoDB -tabell, og er en viktig del av DynamoDB API. Andre vanlige operasjoner inkluderer GetItem, UpdateItem og DeleteItem. Sammen gir disse operasjonene et rikt sett med alternativer å lese fra og skrive til DynamoDB -tabeller.