Este artículo trata todo sobre la operación UpdateItem. Aprenderá sobre la sinopsis de la operación, los parámetros y cómo usarla.
Sinopsis y parámetros de DynamoDB
Como cualquier otra operación de base de datos, la operación UpdateItem de DynamoDB presenta una sinopsis y los parámetros relevantes. La sinopsis de Python para esta operación se muestra a continuación. Puede variar ligeramente según su lenguaje de programación, pero la mayoría de los parámetros deben permanecer iguales.
Actualizar elemento (
Nombre de la tabla = 'cuerda' ,
Llave = {
'cuerda' : { 'S' : 'cuerda' , 'NORTE' : 'cuerda' , 'B' : b 'bytes' , 'SS' : [ 'cuerda' , ... ] , 'NS' : [ 'cuerda' , ... ] , 'BS' : [ b 'bytes' , ... ] }
} ,
ActualizarExpresión = 'cuerda' ,
CondiciónExpresión = 'cuerda' ,
ExpressionAttributeValuesExpressionAttributeValuesExpressionAttributeValues = {
':cuerda' : { 'S' : 'cuerda' , 'NORTE' : 'cuerda' , 'B' : b 'bytes' , 'SS' : [ 'cuerda' , ... ] , 'NS' : [ 'cuerda' , ... ] , 'BS' : [ b 'bytes' , ... ] } ,
...
} ,
valores devueltos = 'NINGUNO' ,
RetornoConsumidoCapacidad = 'ÍNDICES' ,
ReturnItemCollectionMetrics = 'TALLA'
)
Para usar la operación UpdateItem en Amazon DynamoDB, deberá usar la sintaxis anterior y proporcionar varios parámetros que especifiquen el elemento que desea 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 de DynamoDB que contiene el elemento que desea actualizar.
- Llave : La clave principal (clave de partición/clave de ordenación) del elemento que necesita actualizar. Asegúrese de especificar esto como un mapa de pares de nombre/valor de atributo.
- ActualizarExpresión : 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ónExpresión : esta cadena opcional especifica una condición para la operación updateitem. La actualización solo tendrá éxito si la condición se evalúa como Verdadera.
- ExpressionAttributeNamesExpressionAttributeNames : Es un mapa de nombres de atributos de marcador de posición que se usan a menudo en UpdateExpression para los nombres de atributos reales que se usan en la tabla. Este parámetro solo es necesario si alguno de los nombres de atributo en UpdateExpression incluye palabras reservadas o caracteres especiales.
- ExpressionAttributeValuesExpressionAttributeValuesExpressionAttributeValues : Este es un mapa de valores de marcador de posición utilizados en UpdateExpression a los valores reales que pretende utilizar en la operación de actualización. Resulta útil si alguno de los valores de atributo en UpdateExpression son expresiones o variables.
- valores devueltos : Esto especifica qué información necesitará que se le devuelva cuando la operación sea exitosa. El valor predeterminado es NINGUNO, lo que significa que no encontrará ninguna información en la respuesta.
- RetornoConsumidoCapacidad : Esto especifica cuánta capacidad consumió 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 la cantidad de colecciones de elementos afectadas por la operación updateitem de DynamoDb. El valor predeterminado es NINGUNO, lo que significa que no se devuelve esta información.
Al usar AWS CLI, la sintaxis de DynamoDB UpdateItem debería tener este aspecto:
elemento de actualización de aws dynamodb \--nombre de la tabla NOMBRE DE LA TABLA \
--llave '{ 'NOMBRE_CLAVE': {'S': 'VALOR_CLAVE' } }' \
--update-expresión 'ESTABLECER NOMBRE_ATTRIBUTO = :val1, NOMBRE_ATTRIBUTO2 = :val2' \
--expresión-valores-atributos '{ ':val1': {'S': 'ATTRIBUTE_VALUE' }, ':val2': {'N': 'ATTRIBUTE_VALUE' } }' \
--valores devueltos ACTUALIZADO_ANTERIOR
Ejemplos sobre cómo usar la operación UpdateItem de DynamoDB
La operación UpdateItem de DynamoDB es fácil de usar. Y mientras lo hace, asegúrese de incluir el atributo de clave principal y UpdateExpression.
A continuación se muestra un ejemplo de cómo puede utilizar la operación UpdateItem para modificar una tabla de DynamoDB:
elemento de actualización de aws dynamodb \--nombre de la tabla Música \
--llave '{ 'Artista': {'S': 'Sauti Sol'}, 'Título de la canción': {'S': 'Siente mi amor'}}' \
--update-expresión 'SET AlbumTitle = :newval' \
--expresión-valores-atributos '{':newval':{'S':'Título del álbum actualizado'}}' \
--valores devueltos TODO NUEVO
Los resultados de la operación anterior deberían verse así:
Conclusión
La operación UpdateItem de DynamoDB es fácil de usar. Puede usarlo para modificar elementos dentro de tablas existentes o agregar elementos a una tabla ya existente. Tenga en cuenta que debe especificar la clave principal y UpdateExpression para que la operación se realice correctamente. Además, tenga en cuenta su entorno. Finalmente, la operación UpdateItem de DynamoDB, como el resto de operaciones, funciona con AWS SDK y AWS CLI.