Selles artiklis käsitletakse kõike toimingu UpdateItem kohta. Saate teada operatsiooni lühikokkuvõtte, parameetrite ja selle kasutamise kohta.
DynamoDB kokkuvõte ja parameetrid
Nagu iga teine andmebaasi toiming, sisaldab ka DynamoDB UpdateItem toiming kokkuvõtet ja asjakohaseid parameetreid. Selle toimingu Pythoni kokkuvõte on järgmine. See võib teie programmeerimiskeelest olenevalt veidi erineda, kuid enamik parameetreid peaks jääma samaks.
Värskenda üksust (
Tabelinimi = 'string' ,
Võti = {
'string' : { 'S' : 'string' , 'N' : 'string' , 'B' : b 'baidid' , 'SS' : [ 'string' , ... ] , 'NS' : [ 'string' , ... ] , 'BS' : [ b 'baidid' , ... ] }
} ,
Värskenda väljendit = 'string' ,
Tingimusekspressioon = 'string' ,
ExpressionAttributeValues = {
':string' : { 'S' : 'string' , 'N' : 'string' , 'B' : b 'baidid' , 'SS' : [ 'string' , ... ] , 'NS' : [ 'string' , ... ] , 'BS' : [ b 'baidid' , ... ] } ,
...
} ,
ReturnValues = 'MITTE ÜKSKI' ,
ReturnConsumedCapacity = 'INDEXES' ,
ReturnItemCollectionMetrics = 'SIZE'
)
Toimingu UpdateItem kasutamiseks Amazon DynamoDB-s peate kasutama ülaltoodud süntaksit ja esitama mitu parameetrit, mis määravad üksuse, mida kavatsete värskendada. Samuti peate uue sätte jaoks määrama uued atribuudi väärtused.
Eelkõige peaks tüüpiline DynamoDB UpdateItem käsk sisaldama järgmisi parameetreid:
- Tabelinimi : DynamoDB tabeli nimi, mis sisaldab üksust, mida soovite värskendada.
- Võti : värskendamist vajava üksuse primaarvõti (partitsioonivõti/sordivõti). Veenduge, et määrate selle atribuudi nime/väärtuse paaride kaardina.
- Värskenda väljendit : avaldis, mis määratleb atribuudid, mida peaksite värskendama, ja nende atribuutide uued väärtused.
Lisaks peate võib-olla esitama allpool valikulised parameetrid. Need parameetrid on valikulised ja sõltuvad teie keskkonnast:
- Tingimusekspressioon : see valikuline string määrab üksuse värskendamise toimingu tingimuse. Värskendus õnnestub ainult siis, kui tingimuse väärtuseks on Tõene.
- ExpressionAttributeNames : see on UpdateExpressionis sageli kasutatavate kohahoidjate atribuutide nimede ja tabelis kasutatavate tegelike atribuutide nimede kaart. See parameeter on vajalik ainult siis, kui mõni UpdateExpressioni atribuudinimedest sisaldab reserveeritud sõnu ja/või erimärke.
- ExpressionAttributeValues : see on UpdateExpressionis kasutatavate kohatäiteväärtuste kaart tegelike väärtustega, mida kavatsete värskendustoimingus kasutada. See on kasulik, kui mõni UpdateExpressioni atribuudi väärtustest on avaldised või muutujad.
- ReturnValues : see määrab, millist teavet peate toimingu õnnestumisel tagastama. Vaikeväärtus on NONE, mis tähendab, et te ei leia vastuse kohta teavet.
- ReturnConsumedCapacity : see määrab, kui palju võimsust värskendustoiming tarbis. Selle vaikeväärtus on NONE, mis tähendab, et te ei leia seda teavet tagastusväärtusest.
- ReturnItemCollectionMetrics : see määrab DynamoDb värskendusüksuse toimimisest mõjutatud üksuste kogude arvu. Vaikeväärtus on NONE, mis tähendab, et seda teavet ei tagastata.
AWS CLI kasutamisel peaks DynamoDB UpdateItem süntaks välja nägema järgmine:
aws dynamodb värskendusüksus \--tabeli nimi TABLE_NAME \
--võti '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--värskendusekspressioon 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--avaldis-atribuut-väärtused '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--tagastusväärtused UPDATED_OLD
Näited DynamoDB UpdateItem operatsiooni kasutamise kohta
DynamoDB UpdateItem toimingut on lihtne kasutada. Ja selle juures veenduge, et lisate primaarvõtme atribuudi ja UpdateExpression.
Allpool on näide selle kohta, kuidas saate DynamoDB tabeli muutmiseks kasutada toimingut UpdateItem.
aws dynamodb värskendusüksus \--tabeli nimi Muusika \
--võti '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--värskendusekspressioon 'SET AlbumTitle = :newval' \
--avaldis-atribuut-väärtused '{':newval':{'S':'Albumi pealkiri on värskendatud'}}' \
--tagastusväärtused KÕIK UUS
Ülaltoodud toimingu tulemused peaksid välja nägema järgmised:
Järeldus
DynamoDB UpdateItem operatsiooni on lihtne kasutada. Saate seda kasutada olemasolevate tabelite üksuste muutmiseks või juba olemasolevasse tabelisse üksuste lisamiseks. Pange tähele, et toimingu õnnestumiseks peate määrama primaarvõtme ja UpdateExpressioni. Samuti olge tähelepanelik oma keskkonna suhtes. Lõpuks töötab DynamoDB UpdateItem Operation, nagu ka ülejäänud toimingud, AWS SDK-de ja AWS CLI-ga.