DynamoDB Puitem Operação Visão geral, sintaxe e exemplos

A operação do DynamoDB PutItem ajuda a criar um novo item ou substituir um item existente em uma tabela de dynamoDB. Ajuda notavelmente a manter a consistência em suas mesas, garantindo que você armazene convenientemente seus dados de maneira organizada.

Quando você usa este comando ou qualquer um de seus derivados com teclas primárias que são as mesmas de um item já existente, ele substitui o item. Por outro lado, você pode usá -lo para adicionar um item alavancando a operação de put condicional.

Este tutorial discute tudo o que você deve saber sobre o DynamoDB. Vamos passar por uma breve visão geral, sua sintaxe e alguns casos de uso.

Vamos começar!

Sintaxe do comando putitem dynamoDB

Idealmente, você pode usar a operação do DynamoDB PutItem com qualquer um dos SDKs da AWS ou com a AWS CLI API Call. De qualquer maneira, você precisa fornecer o nome da tabela na qual deseja fazer uma adição ou substituição de itens e um dicionário de pares de nomes de nomes de atributo que definem as propriedades do item.

Você também pode precisar especificar os parâmetros opcionais, como os principais valores -chave do item, os valores esperados para certos atributos específicos e os valores de retorno que você espera da resposta do dynamoDB.

Se você especificar um valor de atributo que não existe no esquema da tabela especificada, o DynamoDB cria o atributo para você. No entanto, se você tentar atualizar um atributo que não é permitido pelo esquema da tabela, a operação falha.

A operação PutItem se destaca como uma operação idempotente, implicando que várias solicitações idênticas têm o mesmo efeito que uma única solicitação. Isso pode ser útil quando você deseja garantir que você crie, atualize ou substitua um item em uma tabela DynamoDB, mesmo que a operação seja reconstruída várias vezes.

A operação PutItem retorna um dicionário de pares de nomes de atributo, representando o item como ele aparece na tabela após a conclusão da operação. Isso pode ser útil para depuração ou para verificar se o item é armazenado corretamente.

a. Usando a AWS CLI para operação de putitem do DynamoDB

A sintaxe da CLI da AWS para operação do DynamoDB PutItem é a seguinte:

AWS DynamoDB put-Item \
--Nome da tabela my_table \
--item '"pk": "s": "a12345b", "sk": "s": "x67890y", "att1": "n": "c123d", "attr2": "S": "ABC" '

Este exemplo adiciona um novo item ao “minha mesa”Tabela que possui atributos de chave primária - pk e sk. O valor para os atributos primários, PK e SK, são x12345y e A67890b, respectivamente. O item também apresenta atributos adicionais como Att1 com um valor numérico de C123D e Att2, que contém um valor de string de ABC.

Você pode usar a opção -Return -Values ​​para especificar os valores que deseja que o DynamoDB retorne na resposta.

Por exemplo, para retornar os valores antigos do atributo para o item que está sendo substituído, você pode usar a seguinte sintaxe:

AWS DynamoDB put-Item \
--Nome da tabela my_table \
--item '"pk": "s": "a12345b", "sk": "s": "x67890y", "att1": "n": "t456u", "attr2": "S": "def" '\
--Valores de retorno all_old

No exemplo anterior, a operação PutItem substitui o item no minha mesa tabela com os novos valores de atributo que são especificados no -item parâmetro. O -valores de retorno Opção Especifica que a resposta do DynamoDB deve retornar os valores antigos do atributo para o item.

b. DynamoDB PutItem Operação usando Python (BOTO3)

Ao usar o Python, a sintaxe deve ficar assim:

Importar BOTO3
# Crie um cliente do DynamoDB
DynamoDB = BOTO3.Client ('DynamoDB')
# Defina o nome da tabela e os atributos do item
tabela_name = 'my_table'
item =
'pk': 's': 'x12345y',
'sk': 's': 'a67890b',
'att1': 'n': '123',
'Att2': 'S': 'ABC'

# Ligue para a operação PutItem
Resposta = DynamoDB.put_item (tableName = tabela_name, item = item)
# Imprima a resposta
Imprimir (resposta)

Como usar a operação do DynamoDB PutItem com o parâmetro ReturnValues

Você também pode usar o parâmetro ReturnValues ​​para especificar quais valores você deseja ser retornado na resposta do dynamoDB. Os valores possíveis para o parâmetro ReturnValues ​​incluem o seguinte:

• NENHUM: Este é o valor padrão e não retorna nenhum valores.
• All_old: Você pode usar isso ao substituir um item. Os atributos do item que você deseja substituir voltam na resposta.
• Atualizado_old: Se o item que está sendo substituído tiver algum valor de atributo que já seja atualizado, a resposta contém os valores antigos.
• TUDO NOVO: Se o item que está sendo substituído tiver algum atributo, a resposta contém seus valores.
• Atualizado_new: Se o item que está sendo substituído tiver algum valor de atributo que foi atualizado, a resposta contém os novos atributos.

Notavelmente, a operação PutItem consome as unidades de capacidade de gravação da capacidade de gravação provisionada da tabela. Se você exceder a capacidade de gravação provisionada da tabela, a operação provavelmente falhará e devolverá um erro provisionado de putaxededEdException.

Conclusão

No geral, a operação do DynamoDB PutItem é uma maneira poderosa de adicionar ou atualizar os itens em uma tabela de dynamoDB e é uma parte importante da API do DynamoDB. Outras operações comuns incluem GetItem, UpdateItem e DeleteItem. Juntos, essas operações fornecem um rico conjunto de opções para ler e escrever para tabelas do DynamoDB.