

# DynamoDB での式属性値の使用
<a name="Expressions.ExpressionAttributeValues"></a>

Amazon DynamoDB の式の属性値は変数として機能します。**式の属性値は、比較する実際の値 (ランタイムまでは不明である可能性のある値) の代わりになります。式の属性値はコロン (`:`) で始まり、1 つ以上の英数字が続きます。

たとえば、`ProductCatalog` で入手でき、費用が `Black` 以下の `500` 項目のすべてを返すとします。この `Scan` (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
```

`--expression-attribute-values` の引数は、ファイル `values.json` に保存されます。

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

式属性値を定義した場合、式全体で一貫して使用する必要があります。さらに、`:` 記号を省略することはできません。

式の属性値は、主な条件式、条件式、更新式、およびフィルター式で使用されます。