DynamoDB の条件式とフィルター式、演算子、関数

Amazon DynamoDB テーブルのデータを操作するには、PutItem、UpdateItem、DeleteItem の各オペレーションを使用します。これらのデータ操作オペレーションでは、どの項目を修正する必要があるかを判断するために、条件式を指定できます。条件式が true と評価される場合、オペレーションは成功します。それ以外の場合は、このオペレーションは失敗します。

このセクションでは、Amazon DynamoDB の書き込みフィルター式と条件式の組み込み関数およびキーワードについて説明します。DynamoDB で使用する関数とプログラミングの詳細については、「DynamoDB と AWS SDK を使用したプログラミング」と「DynamoDB API リファレンス」を参照してください。

フィルター式と条件式の構文

以下の構文の概要で、operand は次のいずれかです。

condition-expression ::=
      operand comparator operand
    | operand BETWEEN operand AND operand
    | operand IN ( operand (',' operand (, ...) ))
    | function
    | condition AND condition
    | condition OR condition
    | NOT condition
    | ( condition )

comparator ::=
    =
    | <>
    | <
    | <=
    | >
    | >=

function ::=
    attribute_exists (path)
    | attribute_not_exists (path)
    | attribute_type (path, type)
    | begins_with (path, substr)
    | contains (path, operand)
    | size (path)

比較の実行

これらのコンパレータを使用して、オペランドを単一の値と比較します。

値の範囲または値の列挙リストに対してオペランドを比較するには、BETWEEN および IN キーワードを使用します。

関数

以下の関数を使用して、ある属性が項目に存在するか判定したり、属性の値を評価したりします。これらの関数名では大文字と小文字が区別されます。入れ子の属性では、完全ドキュメントパスを指定する必要があります。

論理評価

論理評価を実行するには、AND、OR、NOT キーワードを使用します。以下のリストでは、a と b は評価される条件を示しています。

以下は、オペレーションの AND のコード例です。

dynamodb-local (*)> select * from exprtest where a > 3 and a < 5;

括弧

論理評価の優先順位を変更するには括弧を使用します。たとえば、条件 a と b が true で、条件 c が false であるとします。次の式は true と評価されます。

しかし、条件を括弧で囲むと、それが最初に評価されます。たとえば、次の式は false と評価されます。

以下は、論理評価で括弧を付けたコード例です。

dynamodb-local (*)> select * from exprtest where attribute_type(b, string) or ( a = 5 and c = “coffee”);

条件の優先順位

DynamoDB では、条件は次の優先順位ルールを使用して左から右に評価されます。