翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
フィルター
Query
処理と Scan
処理を使用して DynamoDB のオブジェクトにクエリを実行する場合、オプションで、結果を評価する filter
を指定して、必要な値のみを返すことができます。
Query
または Scan
マッピングドキュメントのフィルタマッピングセクションは以下の構造を持ちます。
"filter" : { "expression" : "filter expression" "expressionNames" : { "#name" : "name", }, "expressionValues" : { ":value" : ... typed value }, }
各フィールドの定義は以下のようになります。
-
expression
-
クエリ式です。フィルター式の記述方法の詳細については、DynamoDB QueryFilter および DynamoDB ScanFilter のドキュメントを参照してください。このフィールドの指定は必須です。
-
expressionNames
-
式の属性名のプレースホルダーを示します。キー - 値のペアの形式になります。キーは、
expression
で使用される名前のプレースホルダーに対応します。値は、DynamoDB の項目の属性名に対応する文字列である必要があります。このフィールドはオプションであり、expression
で使用される式の属性名のプレースホルダーのみを入力します。 -
expressionValues
-
式の属性値のプレースホルダーを示します。キー - 値のペアの形式になります。キーは
expression
で使用される値のプレースホルダーに対応し、値は型付き値でなければなりません。「型付き値」を指定する方法の詳細については、「型システム (リクエストマッピング)」を参照してください。この指定は必須です。このフィールドはオプションであり、expression
で使用される式の属性値のプレースホルダーのみを入力します。
例
次の例は、マッピングテンプレートのフィルターセクションです。ここでは、DynamoDB から取得されたエントリのうち、タイトルが title
引数で始まるもののみが返されます。
"filter" : { "expression" : "begins_with(#title, :title)", "expressionNames" : { "#title" : "title" }, "expressionValues" : { ":title" : $util.dynamodb.toDynamoDBJson($context.arguments.title) } }