Descripción general de la operación Puitem Dynamodb, sintaxis y ejemplos

La operación de Putitem Dynamodb ayuda a crear un nuevo elemento o reemplazar un elemento existente en una tabla DynamodB. Sorprendentemente ayuda a mantener la consistencia en sus tablas asegurando que almacene sus datos convenientemente de manera organizada.

Cuando usa este comando o cualquiera de sus derivadas con claves primarias que son las mismas que las de un elemento ya existente, reemplaza el elemento. Por otro lado, puede usarlo para agregar un elemento aprovechando la operación de colocación condicional.

Este tutorial discute todo lo que debe saber sobre Dynamodb. Pasaremos por una breve descripción general, su sintaxis y algunos casos de uso.

Empecemos!

Sintaxis del comando dynamodb putitem

Idealmente, puede usar la operación Putitem Dynamodb con cualquiera de los SDK de AWS o con AWS CLI API Call. De cualquier manera, debe proporcionar el nombre de la tabla en la que desea hacer una adición o reemplazo del artículo, y un diccionario de pares de valor de atributo que definen las propiedades del artículo.

También es posible que deba especificar los parámetros opcionales, como los valores de clave primarios del elemento, los valores esperados para ciertos atributos específicos/específicos y los valores de retorno que espera de la respuesta DynamodB.

Si especifica un valor de atributo que no existe en el esquema de la tabla especificada, DynamoDB crea el atributo para usted. Sin embargo, si intenta actualizar un atributo que no está permitido por el esquema de la tabla, la operación falla.

La operación de Putitem se destaca como una operación idempotente, lo que implica que múltiples solicitudes idénticas tienen el mismo efecto que una sola solicitud. Esto puede ser útil cuando desea asegurarse de crear, actualizar o reemplazar un elemento en una tabla DynamodB, incluso si la operación está reintentada varias veces.

La operación Putitem devuelve un diccionario de pares de nombre de valor de atributo, que representa el elemento como aparece en la tabla después de que se complete la operación. Esto puede ser útil para la depuración o para verificar que el elemento se almacene correctamente.

a. Uso de AWS CLI para la operación de Putitem Dynamodb

La sintaxis de AWS CLI para la operación de Putitem Dynamodb es la siguiente:

AWS DYNAMODB PUT-ITem \
--nombre de mesa my_table \
--item '"Pk": "S": "A12345b", "Sk": "S": "x67890y", "attr1": "n": "c123d", "attr2": "S": "ABC" '

Este ejemplo agrega un nuevo elemento al "mi mesa"Tabla que tiene atributos clave primarios - paquete y sk. El valor para los atributos primarios, PK y SK, son X12345Y y A67890B, respectivamente. El elemento también presenta atributos adicionales como ATtr1 con un valor numérico de C123D y ATtr2 que contiene un valor de cadena de ABC.

Puede usar la opción -return -values ​​para especificar los valores que desea que el DynamodB devuelva en la respuesta.

Por ejemplo, para devolver los valores de atributo antiguos para el elemento que se está reemplazando, puede usar la siguiente sintaxis:

AWS DYNAMODB PUT-ITem \
--nombre de mesa my_table \
--Elemento '"Pk": "S": "A12345b", "Sk": "S": "x67890y", "attr1": "n": "t456u", "attr2": "S": "def" '\
--Valores de retorno All_old

En el ejemplo anterior, la operación Putitem reemplaza el elemento en el mi mesa tabla con los nuevos valores de atributo que se especifican en el -artículo parámetro. El -Valores de retorno La opción especifica que la respuesta de DynamodB debe devolver los valores de atributo antiguos para el elemento.

b. Operación de Putitem Dynamodb usando Python (Boto3)

Al usar Python, la sintaxis debería verse así:

importar boto3
# Crear un cliente Dynamodb
Dynamodb = Boto3.Cliente ('Dynamodb')
# Establezca el nombre de la tabla y los atributos del elemento
table_name = 'my_table'
item =
'Pk': 's': 'x12345y',
'SK': 'S': 'A67890b',
'Attr1': 'n': '123',
'Attr2': 's': 'ABC'

# Llame a la operación Putitem
Respuesta = Dynamodb.put_item (tableName = table_name, elemento = elemento)
# Imprima la respuesta
Imprimir (respuesta)

Cómo usar la operación Putitem DynamodB con el parámetro ReturnValues

También puede usar el parámetro ReturnValues ​​para especificar qué valores desea devolver en la respuesta Dynamodb. Los valores posibles para el parámetro ReturnValues ​​incluyen lo siguiente:

• NINGUNO: Este es el valor predeterminado y no devuelve ningún valor.
• TODO VIEJO: Puedes usar esto al reemplazar un artículo. Los atributos del elemento que desea reemplazar regresa en la respuesta.
• Actualizado_old: Si el elemento que se está reemplazando tiene algún valor de atributo que ya está actualizado, la respuesta contiene los valores antiguos.
• TODO NUEVO: Si el elemento que se está reemplazando tiene algún atributo, la respuesta contiene sus valores.
• Actualizado_new: Si el elemento que se está reemplazando tiene algún valor de atributo que se actualizó, la respuesta contiene los nuevos atributos.

En particular, la operación Putitem consume las unidades de capacidad de escritura de la capacidad de escritura aprovisionada de la tabla. Si excede la capacidad de escritura aprovisionada de la tabla, la operación probablemente fallará y devolverá un error provisional.

Conclusión

En general, la operación DynamodB Putitem es una forma poderosa de agregar o actualizar los elementos en una tabla DynamodB, y es una parte importante de la API DynamodB. Otras operaciones comunes incluyen GetItem, UpdateItem y DeleteItem. Juntas, estas operaciones proporcionan un rico conjunto de opciones para leer y escribir en las tablas de Dynamodb.