Operación DynamodB UpdateItem

La operación UpdateItem en AWS DynamoDB ayuda a los administradores de bases de datos a modificar o editar una tabla DynamoDB existente. Le permite actualizar uno o más atributos de un elemento ya existente o agregar un nuevo elemento a un nuevo elemento a una tabla existente dentro de su base de datos. En particular, también puede usar esta operación para reemplazar un par de valor de atributo existente.

Este artículo discute todo sobre la operación de UpdateItem. Aprenderá sobre la sinopsis de la operación, los parámetros y cómo usarla.

Sinopsis y parámetros de DynamodB

Al igual que cualquier otra operación de base de datos, la operación Dynamodb UpdateItem presenta una sinopsis y los parámetros relevantes. La sinopsis de Python para esta operación es como se muestra a continuación. Puede variar ligeramente en función de su lenguaje de programación, pero la mayoría de los parámetros deben seguir siendo los mismos.

UpdateItem (
TableName = 'String',
Clave =
'String': 'S': 'String', 'n': 'String', 'b': b'bytes ',' ss ': [' string ', ...],' ns ': [' string ' , ...], 'bs': [b'bytes ', ...]
,
UpdateExpression = 'String',
ConditionExpression = 'String',
ExpressionAttributeValues ​​=
': string': 's': 'string', 'n': 'string', 'b': b'bytes ',' ss ': [' string ', ...],' ns ': [' string ', ...],' bs ': [b'bytes', ...],
…
,
ReturnValues ​​= 'Ninguno',
ReturnConsumedCapacity = 'índices',
ReturnitemCollectionMetrics = 'tamaño'
)

Para utilizar la operación UpdateItem en Amazon Dynamodb, deberá usar la sintaxis anterior y proporcionar varios parámetros que especifiquen el elemento que tiene la intención de actualizar. También deberá especificar los nuevos valores de atributo para la nueva configuración.

En particular, un comando típico de DynamodB UpdateItem debe contener los siguientes parámetros:

• Nombre de la tabla: El nombre de la tabla Dynamodb que contiene el elemento que desea actualizar.
• Llave: La clave principal (tecla de partición/tecla de clasificación) del elemento que necesita actualizado. Asegúrese de especificar esto como un mapa de pares de nombre/valor de atributo.
• UpdateExpression: Una expresión que define los atributos que debe actualizar y los nuevos valores para esos atributos.

Además, es posible que deba proporcionar los parámetros opcionales a continuación. Estos parámetros son opcionales y dependerán de su entorno:

• Condición de expresión: Esta cadena opcional especifica una condición para la operación de UpdateItem. La actualización solo tendrá éxito si la condición se evalúa a verdaderas.
• ExpressionAttributeNames: Es el mapa de los nombres de los atributos de marcador de posición que se usa a menudo en el updateExpression a los nombres de atributos reales como se usan en la tabla. Este parámetro solo es necesario si alguno de los nombres de atributos en el updateExpression presenta palabras reservadas o/y caracteres especiales.
• ExpressionAttributeValues: Este es un mapa de valores de marcador de posición utilizado en el updateExpression a los valores reales que pretende usar en la operación de actualización. Es útil si alguno de los valores de atributos en la updateExpression son expresiones o variables.
• Valores de retorno: Esto especifica qué información necesitará devolver sobre el éxito de la operación. El valor predeterminado es ninguno, lo que significa que no encontrará ninguna información sobre la respuesta.
• ReturnconsumedCapacity: Esto especifica cuánta capacidad fue consumida por la operación de actualización. Su valor predeterminado es ninguno, lo que implica que no encontrará esta información en el valor de retorno.
• ReturnitemCollectionMetrics: Esto especifica el número de colecciones de elementos afectadas por la operación DynamoDB UpdateItem. El valor predeterminado es ninguno, lo que significa que esta información no se devuelve.

Cuando se usa AWS CLI, la sintaxis Dynamodb UpdateItem debería verse así:

AWS Dynamodb Update-Item \
--Nombre de la tabla Table_name \
--Key '"Key_Name": "S": "Key_Value"' \
--Update-Expression "set attribute_name =: val1, attribute_name2 =: val2" \ \
--Expression-attribute-values ​​'": val1": "s": "attribute_value", ": val2": "n": "attribute_value"' \ \
--Valores de retorno actualizado_old

Ejemplos sobre cómo usar la operación Dynamodb UpdateItem

La operación DynamodB UpdateItem es fácil de usar. Y mientras está en él, asegúrese de incluir el atributo clave principal y el updateExpression.

A continuación se muestra un ejemplo de cómo puede usar la operación UpdateItem para modificar una tabla DynamodB:

AWS Dynamodb Update-Item \
--Música de nombre de mesa \
--Key '"Artista": "S": "Sauti Sol", "Songtitle": "S": "Feel My Love"' \
--Update-Expression "Set AlbumTitle =: NewVal" \
--Expression-attribute-values ​​'": newval": "S": "Título del álbum actualizado"' \
--Valores de retorno all_new

Los resultados para la operación anterior deben verse así:

Conclusión

La operación Dynamodb UpdateItem es fácil de usar. Puede usarlo para modificar los elementos dentro de las tablas existentes o agregar elementos a una tabla ya existente. Tenga en cuenta que debe especificar la clave principal y la updateExpression para que la operación tenga éxito. Además, tenga en cuenta su entorno. Finalmente, la operación Dynamodb UpdateItem, como el resto de las operaciones, funciona con AWS SDKS y AWS CLI.