Šajā rakstā ir apskatīts viss par UpdateItem darbību. Jūs uzzināsiet par operācijas kopsavilkumu, parametriem un to izmantošanu.
DynamoDB konspekts un parametri
Tāpat kā jebkura cita datu bāzes operācija, DynamoDB UpdateItem darbībai ir kopsavilkums un attiecīgie parametri. Šīs darbības Python kopsavilkums ir parādīts tālāk. Tas var nedaudz atšķirties atkarībā no jūsu programmēšanas valodas, taču lielākajai daļai parametru ir jāpaliek nemainīgam.
Atjaunināt vienumu (
Tabulas nosaukums = 'string' ,
Atslēga = {
'string' : { 'S' : 'string' , 'N' : 'string' , 'B' : b 'baiti' , 'SS' : [ 'string' ,... ] , 'NS' : [ 'string' ,... ] , 'BS' : [ b 'baiti' ,... ] }
} ,
UpdateExpression = 'string' ,
NosacījumaIzteiksme = 'string' ,
ExpressionAttributeValues = {
':string' : { 'S' : 'string' , 'N' : 'string' , 'B' : b 'baiti' , 'SS' : [ 'string' ,... ] , 'NS' : [ 'string' ,... ] , 'BS' : [ b 'baiti' ,... ] } ,
...
} ,
ReturnValues = 'NEVIENS' ,
ReturnConsumedCapacity = 'INDEXES' ,
ReturnItemCollectionMetrics = 'IZMĒRS'
)
Lai pakalpojumā Amazon DynamoDB izmantotu darbību UpdateItem, jums būs jāizmanto iepriekš minētā sintakse un jānorāda vairāki parametri, kas norāda vienumu, kuru plānojat atjaunināt. Jums būs arī jānorāda jaunā iestatījuma jaunās atribūtu vērtības.
Konkrēti, tipiskā DynamoDB UpdateItem komandā jāietver šādi parametri:
- Tabulas nosaukums : DynamoDB tabulas nosaukums, kurā ir vienums, kuru vēlaties atjaunināt.
- Atslēga : Atjaunināmā vienuma primārā atslēga (sadaļas atslēga/kārtošanas atslēga). Noteikti norādiet to kā atribūtu nosaukuma/vērtības pāru karti.
- UpdateExpression : izteiksme, kas definē atjaunināmos atribūtus un šo atribūtu jaunās vērtības.
Turklāt, iespējams, būs jānorāda tālāk norādītie izvēles parametri. Šie parametri nav obligāti un ir atkarīgi no jūsu vides:
- NosacījumaIzteiksme : šī izvēles virkne norāda nosacījumu atjaunināšanas vienuma darbībai. Atjaunināšana būs veiksmīga tikai tad, ja nosacījums tiks novērtēts kā True.
- ExpressionAttributeNames : Tā ir vietturu atribūtu nosaukumu karte, ko bieži izmanto UpdateExpression ar faktiskajiem atribūtu nosaukumiem, kas izmantoti tabulā. Šis parametrs ir nepieciešams tikai tad, ja kādā no UpdateExpression atribūtu nosaukumiem ir rezervēti vārdi un/vai īpašās rakstzīmes.
- ExpressionAttributeValues : šī ir vietturu vērtību karte, kas tiek izmantota UpdateExpression ar faktiskajām vērtībām, kuras plānojat izmantot atjaunināšanas darbībā. Tas noder, ja kāda no UpdateExpression atribūtu vērtībām ir izteiksmes vai mainīgie.
- ReturnValues : Tas norāda, kāda informācija jums būs jāatgriež pēc veiksmīgas operācijas. Noklusējuma vērtība ir NONE, kas nozīmē, ka jūs neatradīsit nekādu informāciju par atbildi.
- ReturnConsumedCapacity : norāda, cik daudz jaudas patērēja atjaunināšanas darbība. Tā noklusējuma vērtība ir NONE, kas nozīmē, ka jūs neatradīsit šo informāciju atgriešanas vērtībā.
- ReturnItemCollectionMetrics : norāda to vienumu kolekciju skaitu, kuras ietekmē DynamoDb atjaunināšanas vienuma darbība. Noklusējuma vērtība ir NONE, kas nozīmē, ka šī informācija netiek atgriezta.
Izmantojot AWS CLI, DynamoDB UpdateItem sintaksei vajadzētu izskatīties šādi:
aws dynamodb atjaunināšanas vienums \-- tabulas nosaukums TABLE_NAME \
-- atslēga '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--atjaunināšanas izteiksme 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--izteiksme-atribūta vērtības '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--atdeves vērtības UPDATED_OLD
Piemēri, kā izmantot DynamoDB UpdateItem darbību
DynamoDB UpdateItem darbību ir viegli lietot. Un tajā pašā laikā noteikti iekļaujiet primārās atslēgas atribūtu un UpdateExpression.
Tālāk ir sniegts piemērs tam, kā varat izmantot operāciju UpdateItem, lai modificētu DynamoDB tabulu:
aws dynamodb atjaunināšanas vienums \-- tabulas nosaukums Mūzika\
-- atslēga '{ 'Mākslinieks': {'S': 'Sauti Sol'}, 'Dziesmas nosaukums': {'S': 'Feel My Love'}}' \
--atjaunināšanas izteiksme 'SET AlbumTitle = :newval' \
--izteiksme-atribūta vērtības '{':newval':{'S':'Atjaunināts albuma nosaukums'}}' \
--atdeves vērtības VISS JAUNS
Iepriekš minētās darbības rezultātiem vajadzētu izskatīties šādi:
Secinājums
DynamoDB UpdateItem darbība ir viegli lietojama. Varat to izmantot, lai modificētu vienumus esošajās tabulās vai pievienotu vienumus jau esošai tabulai. Ņemiet vērā, ka, lai darbība būtu veiksmīga, ir jānorāda primārā atslēga un UpdateExpression. Tāpat esiet uzmanīgs pret savu vidi. Visbeidzot, DynamoDB UpdateItem operācija, tāpat kā pārējās darbības, darbojas ar AWS SDK un AWS CLI.