Tässä artikkelissa käsitellään kaikkea UpdateItem-toiminnosta. Opit toiminnan yhteenvedosta, parametreista ja sen käytöstä.
DynamoDB Synopsis ja parametrit
Kuten kaikki muut tietokantatoiminnot, DynamoDB UpdateItem -toiminto sisältää yhteenvedon ja asiaankuuluvat parametrit. Tämän toiminnon Python-tiivistelmä on alla kuvattu. Se voi vaihdella hieman ohjelmointikielesi mukaan, mutta useimpien parametrien tulisi pysyä samoina.
Päivitä kohde (
Taulukon nimi = 'merkkijono' ,
Avain = {
'merkkijono' : { 'S' : 'merkkijono' , 'N' : 'merkkijono' , 'B' : b 'tavua' , 'SS' : [ 'merkkijono' ,... ] , 'NS' : [ 'merkkijono' ,... ] , 'BS' : [ b 'tavua' ,... ] }
} ,
PäivitäExpression = 'merkkijono' ,
ConditionExpression = 'merkkijono' ,
ExpressionAttributeValues = {
':string' : { 'S' : 'merkkijono' , 'N' : 'merkkijono' , 'B' : b 'tavua' , 'SS' : [ 'merkkijono' ,... ] , 'NS' : [ 'merkkijono' ,... ] , 'BS' : [ b 'tavua' ,... ] } ,
...
} ,
ReturnValues = 'EI MITÄÄN' ,
ReturnConsumedCapacity = 'INDEXES' ,
ReturnItemCollectionMetrics = 'KOKO'
)
Jotta voit käyttää UpdateItem-toimintoa Amazon DynamoDB:ssä, sinun on käytettävä yllä olevaa syntaksia ja annettava useita parametreja, jotka määrittävät päivitettävän kohteen. Sinun on myös määritettävä uudet attribuuttiarvot uudelle asetukselle.
Erityisesti tyypillisen DynamoDB UpdateItem -komennon tulisi sisältää seuraavat parametrit:
- Taulukon nimi : Päivitettävän kohteen sisältävän DynamoDB-taulukon nimi.
- Avain : Päivitettävän kohteen ensisijainen avain (osioavain/lajitteluavain). Varmista, että määrität tämän määritteen nimi/arvo-parien kartaksi.
- PäivitäExpression : Lauseke, joka määrittää attribuutit, jotka sinun tulee päivittää, ja näiden määritteiden uudet arvot.
Lisäksi saatat joutua antamaan valinnaiset parametrit alla. Nämä parametrit ovat valinnaisia ja riippuvat ympäristöstäsi:
- ConditionExpression : Tämä valinnainen merkkijono määrittää ehdon updateitem-toiminnolle. Päivitys onnistuu vain, jos ehdon arvo on tosi.
- ExpressionAttributeNames : Se on kartta UpdateExpressionissa usein käytetyistä paikkamerkkimääritteiden nimistä taulukossa käytettyihin todellisiin määritteiden nimiin. Tämä parametri on tarpeen vain, jos jokin UpdateExpressionin attribuuttien nimistä sisältää varattuja sanoja ja/tai erikoismerkkejä.
- ExpressionAttributeValues : Tämä on kartta UpdateExpressionissa käytetyistä paikkamerkkiarvoista todellisiin arvoihin, joita aiot käyttää päivitystoiminnossa. Siitä on hyötyä, jos jokin UpdateExpressionin attribuuttiarvoista on lausekkeita tai muuttujia.
- ReturnValues : Tämä määrittää, mitä tietoja tarvitset toimenpiteen onnistumisen jälkeen. Oletusarvo on EI, eli et löydä vastauksesta mitään tietoa.
- ReturnConsumedCapacity : Tämä määrittää, kuinka paljon kapasiteettia päivitys kulutti. Sen oletusarvo on NONE, mikä tarkoittaa, että et löydä tätä tietoa palautusarvosta.
- ReturnItemCollectionMetrics : Tämä määrittää niiden alkiokokoelmien määrän, joihin DynamoDb-päivityskohteen toiminto vaikuttaa. Oletusarvo on NONE, mikä tarkoittaa, että näitä tietoja ei palauteta.
Käytettäessä AWS CLI:tä DynamoDB UpdateItem -syntaksin pitäisi näyttää tältä:
aws dynamodb päivityskohde \--taulukon nimi TABLE_NAME \
--avain '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--päivitys-ilmaisu 'SET ATTRIBUTE_NAME = :arvo1, ATTRIBUTE_NAME2 = :val2' \
--lauseke-attribuutti-arvot '{ ':arvo1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--palautusarvot UPDATED_OLD
Esimerkkejä DynamoDB UpdateItem -toiminnon käyttämisestä
DynamoDB UpdateItem -toimintoa on helppo käyttää. Varmista samalla, että sisällytät ensisijaisen avaimen määritteen ja UpdateExpressionin.
Alla on esimerkki siitä, kuinka voit käyttää UpdateItem-toimintoa DynamoDB-taulukon muokkaamiseen:
aws dynamodb päivityskohde \--taulukon nimi Musiikki \
--avain '{ 'Artisti': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--päivitys-ilmaisu 'SET AlbumTitle = :newval' \
--lauseke-attribuutti-arvot '{':newval':{'S':'Päivitetty albumin nimi'}}' \
--palautusarvot KAIKKI UUTTA
Yllä olevan toimenpiteen tulosten pitäisi näyttää tältä:
Johtopäätös
DynamoDB UpdateItem -toimintoa on helppo käyttää. Voit käyttää sitä muokataksesi kohteita olemassa olevissa taulukoissa tai lisätäksesi kohteita jo olemassa olevaan taulukkoon. Huomaa, että sinun on määritettävä ensisijainen avain ja UpdateExpression, jotta toiminto onnistuu. Muista myös ympäristösi. Lopuksi DynamoDB UpdateItem -toiminto, kuten muutkin toiminnot, toimii AWS SDK:iden ja AWS CLI:n kanssa.