Тази статия обсъжда всичко за операцията UpdateItem. Ще научите за резюмето на операцията, параметрите и как да я използвате.
Синопсис и параметри на DynamoDB
Както всяка друга операция с база данни, операцията DynamoDB UpdateItem включва резюме и съответните параметри. Синопсисът на Python за тази операция е както е показано по-долу. Може леко да варира в зависимост от вашия език за програмиране, но повечето параметри трябва да останат същите.
UpdateItem (
TableName = 'низ' ,
Ключ = {
'низ' : { 'С' : 'низ' , 'Н' : 'низ' , 'Б' : б 'байтове' , 'SS' : [ 'низ' , ... ] , 'NS' : [ 'низ' , ... ] , 'BS' : [ b 'байтове' , ... ] }
} ,
UpdateExpression = 'низ' ,
УсловиеИзраз = 'низ' ,
ExpressionAttributeValues = {
':низ' : { 'С' : 'низ' , 'Н' : 'низ' , 'Б' : б 'байтове' , 'SS' : [ 'низ' , ... ] , 'NS' : [ 'низ' , ... ] , 'BS' : [ b 'байтове' , ... ] } ,
...
} ,
Върнати стойности = 'НИТО ЕДИН' ,
ReturnConsumedCapacity = „ИНДЕКСИ“ ,
ReturnItemCollectionMetrics = 'РАЗМЕР'
)
За да използвате операцията UpdateItem в Amazon DynamoDB, ще трябва да използвате синтаксиса по-горе и да предоставите няколко параметъра, които указват елемента, който възнамерявате да актуализирате. Ще трябва също да посочите новите стойности на атрибута за новата настройка.
По-конкретно, типична команда DynamoDB UpdateItem трябва да съдържа следните параметри:
- TableName : Името на таблицата DynamoDB, съдържаща елемента, който искате да актуализирате.
- Ключ : Първичният ключ (ключ за дял/ключ за сортиране) на елемента, който трябва да актуализирате. Уверете се, че сте посочили това като карта на двойки име/стойност на атрибута.
- UpdateExpression : Израз, който дефинира атрибутите, които трябва да актуализирате, и новите стойности за тези атрибути.
Освен това може да се наложи да предоставите незадължителните параметри по-долу. Тези параметри не са задължителни и ще зависят от вашата среда:
- УсловиеИзраз : Този незадължителен низ указва условие за операцията updateitem. Актуализацията ще бъде успешна само ако условието се оцени като True.
- ExpressionAttributeNames : Това е карта на имената на атрибутите на заместители, които често се използват в UpdateExpression към действителните имена на атрибути, използвани в таблицата. Този параметър е необходим само ако някое от имената на атрибутите в UpdateExpression съдържа запазени думи или/и специални знаци.
- ExpressionAttributeValues : Това е карта на стойностите на контейнери, използвани в UpdateExpression, към действителните стойности, които възнамерявате да използвате в операцията за актуализиране. Това е полезно, ако някоя от стойностите на атрибута в UpdateExpression е израз или променлива.
- Върнати стойности : Това указва каква информация ще ви е необходима при успех на операцията. Стойността по подразбиране е NONE, което означава, че няма да намерите информация за отговора.
- ReturnConsumedCapacity : Това указва колко капацитет е изразходван от операцията за актуализиране. Стойността му по подразбиране е NONE, което означава, че няма да намерите тази информация във върнатата стойност.
- ReturnItemCollectionMetrics : Това определя броя на колекциите от елементи, засегнати от операцията за актуализиране на DynamoDb. Стойността по подразбиране е NONE, което означава, че тази информация не се връща.
Когато използвате AWS CLI, синтаксисът на DynamoDB UpdateItem трябва да изглежда така:
aws dynamodb update-item \--име-на-таблица TABLE_NAME \
--ключ '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--израз-актуализация 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--expression-attribute-values '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--връщани стойности АКТУАЛИЗИРАН_СТАР
Примери за това как да използвате операцията DynamoDB UpdateItem
Операцията DynamoDB UpdateItem е лесна за използване. И докато го правите, уверете се, че сте включили атрибута на първичния ключ и UpdateExpression.
По-долу е даден пример как можете да използвате операцията UpdateItem, за да модифицирате DynamoDB таблица:
aws dynamodb update-item \--име-на-таблица музика \
--ключ '{ 'Изпълнител': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--израз-актуализация 'SET AlbumTitle = :newval' \
--expression-attribute-values '{':newval':{'S':'Актуализирано заглавие на албум'}}' \
--връщани стойности ВСИЧКИ_НОВИ
Резултатите от горната операция трябва да изглеждат така:
Заключение
Операцията DynamoDB UpdateItem е лесна за използване. Можете да го използвате, за да променяте елементи в съществуващи таблици или да добавяте елементи към вече съществуваща таблица. Имайте предвид, че трябва да посочите първичния ключ и UpdateExpression, за да бъде операцията успешна. Освен това имайте предвид околната среда. И накрая, операцията DynamoDB UpdateItem, подобно на останалите операции, работи с AWS SDK и AWS CLI.