В этой статье обсуждается все, что касается операции UpdateItem. Вы узнаете о синопсисе операции, параметрах и способах ее использования.
Описание и параметры DynamoDB
Как и любая другая операция с базой данных, операция DynamoDB UpdateItem содержит краткий обзор и соответствующие параметры. Краткий обзор Python для этой операции показан ниже. Он может незначительно отличаться в зависимости от вашего языка программирования, но большинство параметров должны оставаться прежними.
ОбновитьItem (
ИмяТаблицы знак равно 'нить' ,
Ключ знак равно {
'нить' : { 'С' : 'нить' , 'Н' : 'нить' , 'Б' : б байты , 'SS' : [ 'нить' , ... ] , 'НС' : [ 'нить' , ... ] , «БС» : [ б байты , ... ] }
} ,
ОбновитьВыражение знак равно 'нить' ,
УсловиеВыражение знак равно 'нить' ,
ExpressionAttributeValues знак равно {
':нить' : { 'С' : 'нить' , 'Н' : 'нить' , 'Б' : б байты , 'SS' : [ 'нить' , ... ] , 'НС' : [ 'нить' , ... ] , «БС» : [ б байты , ... ] } ,
...
} ,
Возвращаемые значения знак равно 'НИКТО' ,
Возврат потребляемой емкости знак равно ИНДЕКСЫ ,
Возвратитемколлектионметрикс знак равно 'РАЗМЕР'
)
Чтобы использовать операцию UpdateItem в Amazon DynamoDB, вам потребуется использовать описанный выше синтаксис и указать несколько параметров, указывающих элемент, который вы хотите обновить. Вам также потребуется указать новые значения атрибутов для новой настройки.
Примечательно, что типичная команда DynamoDB UpdateItem должна содержать следующие параметры:
- ИмяТаблицы : имя таблицы DynamoDB, содержащей элемент, который вы хотите обновить.
- Ключ : первичный ключ (ключ раздела/ключ сортировки) элемента, который необходимо обновить. Убедитесь, что вы указали это как карту пар имя/значение атрибута.
- ОбновитьВыражение : выражение, определяющее атрибуты, которые следует обновить, и новые значения этих атрибутов.
Кроме того, вам может потребоваться указать дополнительные параметры ниже. Эти параметры являются необязательными и будут зависеть от вашей среды:
- УсловиеВыражение : Эта необязательная строка указывает условие для операции updateitem. Обновление будет успешным только в том случае, если условие оценивается как True.
- ExpressionAttributeNames : это сопоставление имен атрибутов-заполнителей, часто используемых в UpdateExpression, с фактическими именами атрибутов, используемыми в таблице. Этот параметр необходим только в том случае, если какое-либо из имен атрибутов в UpdateExpression содержит зарезервированные слова и/или специальные символы.
- ExpressionAttributeValues : это сопоставление значений-заполнителей, используемых в UpdateExpression, с фактическими значениями, которые вы собираетесь использовать в операции обновления. Это удобно, если какие-либо значения атрибутов в UpdateExpression являются выражениями или переменными.
- Возвращаемые значения : Это указывает, какая информация вам потребуется, чтобы вернуться после успеха операции. Значение по умолчанию — NONE, что означает, что вы не найдете никакой информации в ответе.
- Возврат потребляемой емкости : указывает, сколько емкости было использовано операцией обновления. Его значение по умолчанию — NONE, что означает, что вы не найдете эту информацию в возвращаемом значении.
- Возвратитемколлектионметрикс : указывает количество коллекций элементов, затронутых операцией updateitem DynamoDb. Значение по умолчанию — NONE, что означает, что эта информация не возвращается.
При использовании AWS CLI синтаксис DynamoDB UpdateItem должен выглядеть следующим образом:
элемент обновления aws dynamodb \--имя-таблицы ТАБЛИЦА_ИМЯ \
--ключ '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--обновление-выражение 'УСТАНОВИТЬ ИМЯ_АТРИБУТА = :val1, ИМЯ_АТРИБУТА2 = :val2' \
--значения-атрибутов-выражений '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--return-значения ОБНОВЛЕНО_OLD
Примеры использования операции DynamoDB UpdateItem
Операция DynamoDB UpdateItem проста в использовании. И при этом убедитесь, что вы включили атрибут первичного ключа и UpdateExpression.
Ниже приведен пример использования операции UpdateItem для изменения таблицы DynamoDB:
элемент обновления aws dynamodb \--имя-таблицы Музыка \
--ключ '{ 'Исполнитель': {'S': 'Саути Сол'}, 'SongTitle': {'S': 'Почувствуй мою любовь'}}' \
--обновление-выражение 'SET AlbumTitle = :newval' \
--значения-атрибутов-выражений '{':newval':{'S':'Обновленное название альбома'}}' \
--return-значения ВСЕ НОВЫЕ
Результаты вышеуказанной операции должны выглядеть следующим образом:
Заключение
DynamoDB UpdateItem Operation проста в использовании. Вы можете использовать его для изменения элементов в существующих таблицах или добавления элементов в уже существующую таблицу. Обратите внимание, что вам необходимо указать первичный ключ и UpdateExpression для успешного выполнения операции. Кроме того, помните об окружающей среде. Наконец, операция DynamoDB UpdateItem, как и остальные операции, работает с AWS SDK и AWS CLI.