

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation de valeurs d’attributs d’expression dans DynamoDB
<a name="Expressions.ExpressionAttributeValues"></a>

Les *valeurs d’attributs d’expression* dans Amazon DynamoDB font office de variables. Elles remplacent les valeurs réelles que vous souhaitez comparer, valeurs que vous ne connaissez peut-être pas avant l’exécution. Une valeur d’attribut d’expression doit commencer par un signe deux-points (`:`) et être suivie d’un ou de plusieurs caractères alphanumériques.

Par exemple, supposons que vous souhaitiez renvoyer tous les éléments de `ProductCatalog` disponibles en `Black` et coûtant au maximum `500`. Vous pouvez utiliser une opération `Scan` avec une expression de filtre, comme dans cet exemple 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
```

Les arguments de la fonction `--expression-attribute-values` sont stockés dans le fichier `values.json`.

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

Si vous définissez une valeur d’attribut d’expression, vous devez l’utiliser systématiquement sur l’ensemble de l’expression. En outre, vous ne pouvez pas ignorer le symbole `:`. 

Les valeurs d’attributs d’expression sont utilisées avec des expressions de condition de clé, des expressions de condition, des expressions de mise à jour et des expressions de filtre.