Dit artikel bespreekt alles over de UpdateItem-bewerking. U leert over de synopsis en parameters van de bewerking en hoe u deze kunt gebruiken.
DynamoDB Synopsis en parameters
Net als elke andere databasebewerking bevat de DynamoDB UpdateItem-bewerking een samenvatting en de relevante parameters. De Python-synopsis voor deze bewerking is zoals hieronder weergegeven. Het kan enigszins variëren op basis van uw programmeertaal, maar de meeste parameters moeten hetzelfde blijven.
Item bijwerken (
Tafel naam = 'draad' ,
Toets = {
'draad' : { 'S' : 'draad' , 'N' : 'draad' , 'B' : b 'bytes' , 'SS' : [ 'draad' , ... ] , 'NS' : [ 'draad' , ... ] , 'BS' : [ b 'bytes' , ... ] }
} ,
Expressie bijwerken = 'draad' ,
VoorwaardeExpressie = 'draad' ,
ExpressionAttributeValues = {
':draad' : { 'S' : 'draad' , 'N' : 'draad' , 'B' : b 'bytes' , 'SS' : [ 'draad' , ... ] , 'NS' : [ 'draad' , ... ] , 'BS' : [ b 'bytes' , ... ] } ,
...
} ,
Retourwaarden = 'GEEN' ,
ReturnConsumedCapacity = 'INDEXEN' ,
ReturnItemCollectionMetrics = 'MAAT'
)
Om de UpdateItem-bewerking in Amazon DynamoDB te gebruiken, moet u de bovenstaande syntaxis gebruiken en verschillende parameters opgeven die het item specificeren dat u wilt bijwerken. U moet ook de nieuwe attribuutwaarden voor de nieuwe instelling opgeven.
Een typisch DynamoDB UpdateItem-commando moet met name de volgende parameters bevatten:
- Tafel naam : De naam van de DynamoDB-tabel met het item dat u wilt bijwerken.
- Toets : De primaire sleutel (partitiesleutel/sorteersleutel) van het item dat u wilt bijwerken. Zorg ervoor dat u dit opgeeft als een toewijzing van kenmerknaam/waarde-paren.
- Expressie bijwerken : Een uitdrukking die de attributen definieert die u moet bijwerken en de nieuwe waarden voor die attributen.
Bovendien moet u mogelijk de onderstaande optionele parameters opgeven. Deze parameters zijn optioneel en zijn afhankelijk van uw omgeving:
- VoorwaardeExpressie : Deze optionele tekenreeks specificeert een voorwaarde voor de bewerking updateitem. De update is alleen geslaagd als de voorwaarde True wordt.
- ExpressionAttributeNames : Het is een kaart van plaatsvervangende attribuutnamen die vaak worden gebruikt in de UpdateExpression naar de feitelijke attribuutnamen zoals gebruikt in de tabel. Deze parameter is alleen nodig als een van de kenmerknamen in de UpdateExpression gereserveerde woorden en/of speciale tekens bevat.
- ExpressionAttributeValues : Dit is een kaart van plaatsaanduidingswaarden die worden gebruikt in de UpdateExpression naar de daadwerkelijke waarden die u wilt gebruiken in de updatebewerking. Het is handig als een van de kenmerkwaarden in de UpdateExpression uitdrukkingen of variabelen zijn.
- Retourwaarden : dit geeft aan welke informatie u nodig heeft als de bewerking is geslaagd. De standaardwaarde is GEEN, wat betekent dat u geen informatie over het antwoord zult vinden.
- ReturnConsumedCapacity : dit geeft aan hoeveel capaciteit is verbruikt door de updatebewerking. De standaardwaarde is NONE, wat inhoudt dat u deze informatie niet zult vinden in de geretourneerde waarde.
- ReturnItemCollectionMetrics : Dit specificeert het aantal itemverzamelingen dat wordt beïnvloed door de DynamoDb updateitem-bewerking. De standaardwaarde is NONE, wat betekent dat deze informatie niet wordt geretourneerd.
Bij gebruik van AWS CLI zou de DynamoDB UpdateItem-syntaxis er als volgt uit moeten zien:
aws dynamodb update-item \--tafel naam TAFEL NAAM \
--toets '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--update-expressie 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--expressie-attribuutwaarden '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--retourwaarden BIJGEWERKT_OUD
Voorbeelden van het gebruik van de bewerking DynamoDB UpdateItem
De bewerking DynamoDB UpdateItem is eenvoudig te gebruiken. En als u toch bezig bent, zorg er dan voor dat u het kenmerk van de primaire sleutel en de UpdateExpression opneemt.
Hieronder ziet u een voorbeeld van hoe u de bewerking UpdateItem kunt gebruiken om een DynamoDB-tabel te wijzigen:
aws dynamodb update-item \--tafel naam Muziek \
--toets '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--update-expressie 'SET AlbumTitle = :newval' \
--expressie-attribuutwaarden '{':newval':{'S':'Bijgewerkte albumtitel'}}' \
--retourwaarden ALLES NIEUW
De resultaten voor de bovenstaande bewerking zouden er als volgt uit moeten zien:
Gevolgtrekking
DynamoDB UpdateItem Bediening is eenvoudig te gebruiken. U kunt het gebruiken om items binnen bestaande tabellen te wijzigen of items toe te voegen aan een reeds bestaande tabel. Houd er rekening mee dat u de primaire sleutel en de UpdateExpression moet opgeven om de bewerking te laten slagen. Houd ook rekening met uw omgeving. Ten slotte werkt de DynamoDB UpdateItem-bewerking, net als de rest van de bewerkingen, met AWS SDK's en AWS CLI.