Syntaxe des expressions de filtre et de condition Comparaisons Fonctions Évaluations logiques Parenthèses Priorité des conditions

Expressions de condition et de filtre, opérateurs et fonctions dans DynamoDB

Manipulez les données d’une table DynamoDB à l’aide des opérations PutItem, UpdateItem et DeleteItem. Pour ces opérations de manipulation de données, vous pouvez préciser une expression de condition afin de déterminer les éléments à modifier. Si l’expression de condition a la valeur true, l’opération aboutit. Sinon, l’opération échoue.

Cette section traite des fonctions et mots clés intégrés pour l’écriture des expressions de filtre et de condition dans Amazon DynamoDB. Pour en savoir plus sur les fonctions et la programmation avec DynamoDB, consultez Programmation avec DynamoDB et le AWS Kits SDK et le guide de référence de l’API DynamoDB.

Rubriques

Syntaxe des expressions de filtre et de condition
Comparaisons
Fonctions
Évaluations logiques
Parenthèses
Priorité des conditions

Syntaxe des expressions de filtre et de condition

Dans le résumé syntaxique suivant, an operand peut être le suivant :

Nom d’attribut de niveau supérieur, par exemple Id, Title, Description ou ProductCategory
Chemin d’accès au document référençant un attribut imbriqué


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)

Comparaisons

Comparez un opérande à une valeur unique à l’aide de ces comparateurs :

a = b— Vrai si la valeur a est égale àb.
a <> b— Vrai si a ce n'est pas égal àb.
a < b— Vrai si la valeur a est inférieure àb.
a <= b— Vrai si la valeur a est inférieure ou égale àb.
a > b— Vrai si la valeur a est supérieure àb.
a >= b— Vrai si la valeur a est supérieure ou égale àb.

Comparez un opérande à une plage de valeurs ou une liste énumérée de valeurs à l’aide des mots clés BETWEEN et IN :

a BETWEEN b AND c— Vrai si la valeur a est supérieure ou égale àb, et inférieure ou égale àc.
a IN (b, c, d)— Vrai si elle a est égale à n'importe quelle valeur de la liste, par exemple bc, ou. d La liste peut comporter jusqu’à 100 valeurs séparées par des virgules.

Pour filtrer un attribut booléen, comparez-le à une valeur booléenne à l'aide de l'<>opérateur = ou. Vous ne pouvez pas référencer l'attribut seul en tant que condition. Indiquez la valeur booléenne dans les valeurs des attributs d'expression. Par exemple, l'expression de filtre suivante renvoie uniquement les éléments dont isVisible l'attribut est true :


--filter-expression "isVisible = :visible" \
--expression-attribute-values '{":visible": {"BOOL": true}}'

Fonctions

Déterminez si un attribut existe dans un élément ou évaluez la valeur d’un attribut à l’aide des fonctions suivantes. Ces noms de fonction respectent la casse. Pour un attribut imbriqué, vous devez fournir le chemin d’accès au document complet.

Fonction	Description
`attribute_exists (path)`	True si l’élément comporte l’attribut spécifié par `path`. Un attribut dont la valeur stockée est de type nul (`NULL`) est toujours considéré comme existant, il `attribute_exists` renvoie donc true. Ceci est différent d'un attribut absent de l'élément. Certains SDK et outils de mappage d'objets omettent les attributs dont la valeur est nulle dans votre application au lieu d'en stocker le `NULL` type. Dans ce cas, l'attribut n'est pas présent et `attribute_exists` renvoie la valeur false. Exemple : Vérifier si un élément de la table `Product` a une image de vue de côté. `attribute_exists (#Pictures.#SideView)`
`attribute_not_exists (path)`	True si l’attribut spécifié par `path` n’existe pas dans l’élément. Exemple : Vérifier si un élément possède un attribut `Manufacturer`. `attribute_not_exists (Manufacturer)`
`attribute_type (path, type)`	True si l’attribut à l’emplacement spécifié est d’un type de données particulier. Le paramètre `type` doit avoir l’une des valeurs suivantes : `S` – String (chaîne) `SS` – String set (ensemble de chaînes) `N` – Number (nombre) `NS` – Number set (ensemble de nombres) `B` – Binary (binaire) `BS` – Binary set (ensemble de binaires) `BOOL` – Boolean (booléen) `NULL` – Null `L` – List (liste) `M` – Map (mappage) Vous devez utiliser une valeur d’attribut d’expression pour le paramètre `type`. Exemple : Vérifier si l’attribut `QuantityOnHand` est de type List (liste). Dans cet exemple, `:v_sub` est un espace réservé pour la chaîne `L`. `attribute_type (ProductReviews.FiveStar, :v_sub)` Vous devez utiliser une valeur d’attribut d’expression pour le paramètre `type`.
`begins_with (path, substr)`	True si l’attribut spécifié par `path` commence par une sous-chaîne particulière. Exemple : Vérifier si les tout premiers caractères de l’URL de l’image de vue avant sont `http://`. `begins_with (Pictures.FrontView, :v_sub)` La valeur d’attribut d’expression `:v_sub` est un espace réservé pour `http://`.
`contains (path, operand)`	True si l’attribut spécifié par `path` est l’un des attributs suivants : Une `String` qui comporte une sous-chaîne particulière Un `Set` qui comporte un élément particulier au sein de l’ensemble Une `List` qui comporte un élément particulier Si l’attribut spécifié par `path` est de type `String`, `operand` doit être de type `String`. Si l’attribut spécifié par `path` est de type `Set`, l’`operand` doit être le type d’élément de l’ensemble. Le chemin d’accès et l’opérande doivent être distincts. Autrement dit, `contains (a, a)` renvoie une erreur. Exemple : Vérifier si l’attribut `Brand` comporte la sous-chaîne `Company`. `contains (Brand, :v_sub)` La valeur d’attribut d’expression `:v_sub` est un espace réservé pour `Company`. Exemple : Vérifier si le produit est disponible en rouge. `contains (Color, :v_sub)` La valeur d’attribut d’expression `:v_sub` est un espace réservé pour `Red`.
`size (path)`	Renvoie un nombre qui représente la taille d’un attribut. Voici les types de données valides à utiliser avec `size`. Si l’attribut est de type `String`, `size` renvoie la longueur de la chaîne. Exemple : Vérifier si la longueur de la chaîne `Brand` est inférieure ou égale à 20 caractères. La valeur d’attribut d’expression `:v_sub` est un espace réservé pour `20`. `size (Brand) <= :v_sub` Si l’attribut est de type `Binary`, `size` renvoie le nombre d’octets de la valeur d’attribut. Exemple : supposez que l’élément `ProductCatalog` comporte un binary attribute nommé `VideoClip` qui comporte une courte vidéo du produit utilisé. L’expression suivante vérifie si `VideoClip` dépasse 64 000 octets. La valeur d’attribut d’expression `:v_sub` est un espace réservé pour `64000`. `size(VideoClip) > :v_sub` Si l’attribut est un type de données `Set`, `size` renvoie le nombre d’éléments dans l’ensemble. Exemple : Vérifier si le produit est disponible dans plusieurs couleurs. La valeur d’attribut d’expression `:v_sub` est un espace réservé pour `1`. `size (Color) < :v_sub` Si l’attribut est de type `List` ou `Map`, `size` renvoie le nombre d’éléments enfants. Exemple : Vérifier si le nombre de révisions `OneStar` a dépassé un certain seuil. La valeur d’attribut d’expression `:v_sub` est un espace réservé pour `3`. `size(ProductReviews.OneStar) > :v_sub`

Évaluations logiques

Effectuez les évaluations logiques à l’aide des mots clés AND, OR et NOT. Dans la liste suivante, a et b représentent les conditions à évaluer.

a AND b— Vrai si a et si b les deux sont vrais.
a OR b— Vrai si l'un a ou l'autre b (ou les deux) sont vrais.
NOT a— Vrai si a c'est faux. Faux si a c'est vrai.

Voici un exemple de code avec AND dans une opération.

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

Parenthèses

Modifiez la priorité d’une évaluation logique à l’aide de parenthèses. Supposons, par exemple, que les conditions b B a et C soient vraies et que cette condition c soit fausse. L’expression suivante a la valeur true :

a OR b AND c

Toutefois, si vous placez une condition entre parenthèses, elle est évaluée en premier. Par exemple, l’expression suivante a la valeur false :

(a OR b) AND c

Note

Vous pouvez imbriquer des parenthèses dans une expression. Les parenthèses les plus intérieures sont évaluées en premier.

Voici un exemple de code avec des parenthèses dans une évaluation logique.

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

Priorité des conditions

DynamoDB évalue les conditions de gauche à droite à l’aide des règles de priorité suivantes :

= <> < <= > >=
IN
BETWEEN
attribute_exists attribute_not_exists begins_with contains
Parenthèses
NOT
AND
OR

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Expressions de mise à jour

Exemple de commande CLI