Este artigo discute tudo sobre a operação UpdateItem. Você aprenderá sobre a sinopse da operação, parâmetros e como usá-la.
Sinopse e parâmetros do DynamoDB
Como qualquer outra operação de banco de dados, a operação UpdateItem do DynamoDB apresenta uma sinopse e os parâmetros relevantes. A sinopse do Python para esta operação é mostrada abaixo. Pode variar um pouco com base na sua linguagem de programação, mas a maioria dos parâmetros deve permanecer a mesma.
UpdateItem (
Nome da tabela = 'corda' ,
Chave = {
'corda' : { 'S' : 'corda' , 'N' : 'corda' , 'B' :b 'bytes' , 'SS' : [ 'corda' , ... ] , 'NS' : [ 'corda' , ... ] , 'BS' : [ b 'bytes' , ... ] }
} ,
UpdateExpression = 'corda' ,
Expressão de Condição = 'corda' ,
ExpressionAttributeValues = {
':corda' : { 'S' : 'corda' , 'N' : 'corda' , 'B' :b 'bytes' , 'SS' : [ 'corda' , ... ] , 'NS' : [ 'corda' , ... ] , 'BS' : [ b 'bytes' , ... ] } ,
...
} ,
ReturnValues = 'NENHUM' ,
ReturnConsumedCapacity = 'ÍNDICES' ,
ReturnItemCollectionMetrics = 'TAMANHO'
)
Para usar a operação UpdateItem no Amazon DynamoDB, você precisará usar a sintaxe acima e fornecer vários parâmetros que especificam o item que pretende atualizar. Você também precisará especificar os novos valores de atributo para a nova configuração.
Notavelmente, um comando típico do DynamoDB UpdateItem deve conter os seguintes parâmetros:
- Nome da tabela : o nome da tabela do DynamoDB que contém o item que você deseja atualizar.
- Chave : a chave primária (chave de partição/chave de classificação) do item que você precisa atualizar. Assegure-se de especificar isso como um mapa de pares nome/valor do atributo.
- UpdateExpression : uma expressão que define os atributos que você deve atualizar e os novos valores para esses atributos.
Além disso, pode ser necessário fornecer os parâmetros opcionais abaixo. Esses parâmetros são opcionais e dependerão do seu ambiente:
- Expressão de Condição : esta string opcional especifica uma condição para a operação updateitem. A atualização só será bem-sucedida se a condição for avaliada como True.
- ExpressionAttributeNames : é um mapa de nomes de atributos de espaço reservado frequentemente usados em UpdateExpression para os nomes de atributos reais usados na tabela. Este parâmetro só é necessário se algum dos nomes de atributo em UpdateExpression apresentar palavras reservadas e/ou caracteres especiais.
- ExpressionAttributeValues : este é um mapa de valores de espaço reservado usados em UpdateExpression para os valores reais que você pretende usar na operação de atualização. É útil se algum dos valores de atributo em UpdateExpression for expressões ou variáveis.
- ReturnValues : especifica quais informações você precisará retornar após o sucesso da operação. O valor padrão é NONE, o que significa que você não encontrará nenhuma informação na resposta.
- ReturnConsumedCapacity : especifica quanta capacidade foi consumida pela operação de atualização. Seu valor padrão é NONE, o que implica que você não encontrará essa informação no valor de retorno.
- ReturnItemCollectionMetrics : especifica o número de coleções de itens afetadas pela operação updateitem do DynamoDb. O valor padrão é NONE, o que significa que essas informações não são retornadas.
Ao usar a AWS CLI, a sintaxe UpdateItem do DynamoDB deve ser semelhante a esta:
item de atualização do aws dynamodb \--Nome da tabela NOME DA TABELA \
--chave '{ 'KEY_NAME': {'S': 'KEY_VALUE' } }' \
--expressão de atualização 'SET ATTRIBUTE_NAME = :val1, ATTRIBUTE_NAME2 = :val2' \
--expressão-atributo-valores '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--valores-retorno ATUALIZADO_OLD
Exemplos de como usar a operação UpdateItem do DynamoDB
A operação UpdateItem do DynamoDB é fácil de usar. E enquanto isso, certifique-se de incluir o atributo de chave primária e o UpdateExpression.
Abaixo está um exemplo de como você pode usar a operação UpdateItem para modificar uma tabela do DynamoDB:
item de atualização do aws dynamodb \--Nome da tabela Música \
--chave '{ 'Artist': {'S': 'Sauti Sol'}, 'SongTitle': {'S': 'Feel My Love'}}' \
--expressão de atualização 'SET AlbumTitle = :newval' \
--expressão-atributo-valores '{':newval':{'S':'Título do álbum atualizado'}}' \
--valores-retorno TUDO NOVO
Os resultados para a operação acima devem ter a seguinte aparência:
Conclusão
A operação UpdateItem do DynamoDB é fácil de usar. Você pode usá-lo para modificar itens em tabelas existentes ou adicionar itens a uma tabela já existente. Observe que você precisa especificar a chave primária e a UpdateExpression para que a operação seja bem-sucedida. Além disso, esteja atento ao seu ambiente. Por fim, a operação UpdateItem do DynamoDB, como o restante das operações, funciona com AWS SDKs e AWS CLI.