Valores de los atributos de expresión

Si desea comparar un atributo con un valor, defina un valor de atributo de expresión como marcador de posición. Los valores de atributos de expresión en Amazon DynamoDB reemplazan a los valores reales que se desea comparar, que podrían no conocerse hasta el tiempo de ejecución. Un valor de atributo de expresión debe comenzar por un signo de dos puntos (:) y debe ir seguido de uno o más caracteres alfanuméricos.

Por ejemplo, supongamos que desea devolver todos los elementos de ProductCatalogque estén disponibles en el color Black y tengan un precio de 500 o menos. Podría utilizar una operación Scan con una expresión de filtro, como en este ejemplo de la AWS Command Line Interface (AWS CLI).

aws dynamodb scan \
    --table-name ProductCatalog \
    --filter-expression "contains(Color, :c) and Price <= :p" \
    --expression-attribute-values file://values.json

Los argumentos de --expression-attribute-values se almacenan en el archivo values.json.

{
    ":c": { "S": "Black" },
    ":p": { "N": "500" }
}

nota

Una operación de Scan lee todos los elementos de una tabla. Debe evitar utilizar Scan con tablas grandes.

La expresión de filtro se aplica a los resultados de Scan y los elementos que no coinciden con la expresión de filtro se descartan.

Si define un valor de atributo de expresión, debe usarlo de forma coherente en toda la expresión. Además, es importante no omitir el signo :.

Los valores de atributos de expresión se usan con expresiones de condición de clave, expresiones de condición, expresiones de actualización y expresiones de filtro.

nota

Para obtener ejemplos de código específicos de los lenguajes de programación, consulte Introducción a DynamoDB y los SDK de AWS.