DynamoDB UpdateItem Operação
Este artigo discute tudo sobre a operação de atualização. Você aprenderá sobre a sinopse, parâmetros e como usá -la.
Sinopse e parâmetros do dynamoDB
Como todas as outras operações de banco de dados, a operação DynamoDB UpdateItem apresenta uma sinopse e os parâmetros relevantes. A sinopse python para esta operação é como mostrado abaixo. Pode variar um pouco com base na sua linguagem de programação, mas a maioria dos parâmetros deve permanecer a mesma.
UpdateItem (
TableName = 'string',
Chave =
'String': 's': 'string', 'n': 'string', 'b': b'bytes ',' ss ': [' string ',…],' ns ': [' string ' , ...], 'BS': [B'Bytes ',…]
,
Updatexpression = 'string',
Condicionexpression = 'string',
ExpressionAttributeValues =
': string': 's': 'string', 'n': 'string', 'b': b'bytes ',' ss ': [' string ',…],' ns ': [' string ', ...],' BS ': [B'Bytes',…],
..
,
ReturnValues = 'Nenhum',
ReturnConsumedCapacity = 'Indexes',
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 dynamoDB updateItem deve conter os seguintes parâmetros:
- Nome da tabela: O nome da tabela 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. Certifique -se de especificar isso como um mapa de nomes de atributo/pares de valor.
- UpdateExpressão: 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:
- ConditionExpressão: Esta string opcional especifica uma condição para a operação de atualização. A atualização só será bem -sucedida se a condição avaliar para verdadeiro.
- ExpressionAttributen names: É mapa dos nomes de atributos de espaço reservado frequentemente usado na atualização da expressão dos nomes de atributos reais, conforme usado na tabela. Este parâmetro é necessário apenas se algum dos nomes de atributos nos recursos da UpdateExpression características ou/e caracteres especiais.
- ExpressionAttributeValues: Este é um mapa dos valores de espaço reservado usado na atualização da expressão dos valores reais que você pretende usar na operação de atualização. Ele é útil se algum dos valores de atributo na atualização forem expressões ou variáveis.
- ReturnValues: Isso especifica quais informações você precisará retornar ao sucesso da operação. O valor padrão é nenhum, o que significa que você não encontrará nenhuma informação sobre a resposta.
- ReturnConsumedCapacity: Isso especifica quanta capacidade foi consumida pela operação de atualização. Seu valor padrão não é, o que implica que você não encontrará essas informações no valor de retorno.
- ReturnItemCollectionMetrics: Isso especifica o número de coleções de itens afetadas pela operação de atualização do DynamoDB. O valor padrão é nenhum, o que significa que essa informação não é retornada.
Ao usar a AWS CLI, a sintaxe do DynamoDB UpdateItem deve ficar assim:
AWS DynamoDB Update-Item \
--tabela-name table_name \
--key '"key_name": "s": "key_value"' \
--Update-Expression "Set Attribute_name =: Val1, attribute_name2 =: val2" \
--Expression-attribute-values '": val1": "s": "attribption_value", ": val2": "n": "attribute_value"' \
--Valores de retorno atualizados_old
Exemplos sobre como usar a operação de atualização do DynamoDB
A operação de atualização do DynamoDB é fácil de usar. E, ao mesmo tempo, certifique -se de incluir o atributo de chave primária e a atualização.
Abaixo está um exemplo de como você pode usar a operação UpdateItem para modificar uma tabela de dynamoDB:
AWS DynamoDB Update-Item \
--Música de nome de mesa \
--key '"Artist": "S": "Sauti Sol", "Songtitle": "S": "Feel My Love"' \
--Update-Expression "set albumTitle =: newval" \
--Expression-Attribute-Values '": newval": "S": "Título do álbum atualizado"' \
--Valores de retorno all_new
Os resultados para a operação acima devem ser assim:
Conclusão
A operação de atualização do DynamoDB é fácil de usar. Você pode usá -lo para modificar itens nas tabelas existentes ou adicionar itens a uma tabela já existente. Observe que você precisa especificar a chave primária e a atualização para a operação para ser bem -sucedida. Além disso, esteja atento ao seu ambiente. Finalmente, a operação do DynamoDB UpdateItem, como o restante das operações, trabalha com os SDKs da AWS e a AWS CLI.