„DynamoDB UpdateItem“ operacija

Dynamodb Updateitem Operacija



Operacija UpdateItem AWS DynamoDB padeda duomenų bazių valdytojams modifikuoti arba redaguoti esamą DynamoDB lentelę. Tai leidžia atnaujinti vieną ar daugiau jau esamo elemento atributų arba pridėti naują elementą prie naujo elemento esamoje duomenų bazės lentelėje. Pažymėtina, kad šią operaciją taip pat galite naudoti norėdami pakeisti esamą atributo reikšmių porą.

Šiame straipsnyje aptariama viskas apie „UpdateItem“ operaciją. Sužinosite apie operacijos santrauką, parametrus ir kaip jį naudoti.

DynamoDB santrauka ir parametrai

Kaip ir visos kitos duomenų bazės operacijos, „DynamoDB UpdateItem“ operacija turi santrauką ir atitinkamus parametrus. Šios operacijos Python santrauka yra tokia, kaip parodyta toliau. Jis gali šiek tiek skirtis priklausomai nuo jūsų programavimo kalbos, tačiau dauguma parametrų turėtų likti tokie patys.







Atnaujinti elementą (
Lentelės pavadinimas = 'styga' ,
Raktas = {
'styga' : { 'S' : 'styga' , 'N' : 'styga' , 'B' : b 'baitai' , 'SS' : [ 'styga' ,... ] , 'NS' : [ 'styga' ,... ] , 'BS' : [ b 'baitai' ,... ] }
} ,
UpdateExpression = 'styga' ,
Sąlygos išraiška = 'styga' ,
ExpressionAttributeValues = {
':string' : { 'S' : 'styga' , 'N' : 'styga' , 'B' : b 'baitai' , 'SS' : [ 'styga' ,... ] , 'NS' : [ 'styga' ,... ] , 'BS' : [ b 'baitai' ,... ] } ,
...
} ,
ReturnValues = 'NĖ VIENAS' ,
ReturnConsumedCapacity = „INDEKSAI“ ,
„ReturnItemCollectionMetrics“. = DYDIS
)

Norėdami naudoti „UpdateItem“ operaciją „Amazon DynamoDB“, turėsite naudoti aukščiau pateiktą sintaksę ir pateikti kelis parametrus, nurodančius elementą, kurį ketinate atnaujinti. Taip pat turėsite nurodyti naujas atributo reikšmes naujam nustatymui.



Pažymėtina, kad įprastoje DynamoDB UpdateItem komandoje turėtų būti šie parametrai:



  • Lentelės pavadinimas : DynamoDB lentelės, kurioje yra elementas, kurį norite atnaujinti, pavadinimas.
  • Raktas : elemento, kurį reikia atnaujinti, pirminis raktas (skirstymo raktas / rūšiavimo raktas). Įsitikinkite, kad tai nurodėte kaip atributo pavadinimo / reikšmės porų žemėlapį.
  • UpdateExpression : išraiška, apibrėžianti atributus, kuriuos turėtumėte atnaujinti, ir naujas tų atributų reikšmes.

Be to, toliau gali reikėti pateikti pasirenkamus parametrus. Šie parametrai yra neprivalomi ir priklausys nuo jūsų aplinkos:





  • Sąlygos išraiška : ši pasirenkama eilutė nurodo atnaujinimo elemento operacijos sąlygą. Atnaujinimas bus sėkmingas, tik jei sąlyga bus įvertinta kaip True.
  • ExpressionAttributeNames : Tai yra vietos rezervavimo atributų pavadinimų, dažnai naudojamų UpdateExpression, žemėlapis su faktiniais atributų pavadinimais, kurie naudojami lentelėje. Šis parametras būtinas tik tuo atveju, jei kuris nors iš atributų pavadinimų UpdateExpression turi rezervuotų žodžių ir (arba) specialiųjų simbolių.
  • ExpressionAttributeValues : Tai yra vietos rezervavimo reikšmių, naudojamų UpdateExpression, žemėlapis su faktinėmis reikšmėmis, kurias ketinate naudoti naujinimo operacijoje. Tai naudinga, jei kuri nors iš UpdateExpression atributų reikšmių yra išraiškos arba kintamieji.
  • ReturnValues : nurodoma, kokią informaciją jums reikės grąžinti sėkmingai atlikus operaciją. Numatytoji reikšmė yra NONE, tai reiškia, kad nerasite jokios informacijos apie atsakymą.
  • ReturnConsumedCapacity : nurodo, kiek talpos sunaudojo atnaujinimo operacija. Numatytoji jo reikšmė yra NONE, o tai reiškia, kad šios informacijos nerasite grąžinamoje vertėje.
  • „ReturnItemCollectionMetrics“. : nurodomas elementų rinkinių, paveiktų DynamoDb atnaujinimo elemento operacijos, skaičius. Numatytoji reikšmė yra NONE, o tai reiškia, kad ši informacija negrąžinama.

Naudojant AWS CLI, DynamoDB UpdateItem sintaksė turėtų atrodyti taip:

aws dynamodb atnaujinimo elementas \
-- lentelės pavadinimas TABLE_NAME \
--Raktas '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--atnaujinimas-išraiška 'NUSTATYTI ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--išraiška-atributas-reikšmės '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--grąžos vertės UPDATED_OLD

„DynamoDB UpdateItem“ operacijos naudojimo pavyzdžiai

„DynamoDB UpdateItem“ operaciją lengva naudoti. Be to, įsitikinkite, kad įtraukėte pirminio rakto atributą ir UpdateExpression.



Toliau pateikiamas pavyzdys, kaip galite naudoti operaciją UpdateItem modifikuoti DynamoDB lentelę:

aws dynamodb atnaujinimo elementas \
-- lentelės pavadinimas Muzika \
--Raktas '{ 'Atlikėjas': {'S': 'Sauti Sol'}, 'Dainos pavadinimas': {'S': 'Feel My Love'}}' \
--atnaujinimas-išraiška 'NUSTATYTI Albumo pavadinimą = :newval' \
--išraiška-atributas-reikšmės '{':newval':{'S':'Atnaujintas albumo pavadinimas'}}' \
--grąžos vertės VISKAS NAUJA

Aukščiau nurodytos operacijos rezultatai turėtų atrodyti taip:

Išvada

„DynamoDB UpdateItem“ operaciją lengva naudoti. Jį galite naudoti norėdami modifikuoti elementus esamose lentelėse arba įtraukti elementus į jau esamą lentelę. Atminkite, kad norint, kad operacija būtų sėkminga, turite nurodyti pirminį raktą ir atnaujinimo išraišką. Taip pat atkreipkite dėmesį į savo aplinką. Galiausiai, „DynamoDB UpdateItem“ operacija, kaip ir kitos operacijos, veikia su AWS SDK ir AWS CLI.