View a markdown version of this page

Filtrer l'exportation d'une table - Amazon DynamoDB

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.

Filtrer l'exportation d'une table

Au lieu d'exporter un tableau entier, vous pouvez uniquement exporter les éléments et les attributs dont vous avez besoin. DynamoDB exporte uniquement les données correspondant aux expressions que vous fournissez. L'exportation filtrée fonctionne à la fois avec les exportations complètes et les exportations incrémentielles.

Pour une exportation incrémentielle, DynamoDB évalue le filtre par rapport à la dernière image de chaque élément modifié. Pour un élément supprimé, DynamoDB évalue le filtre par rapport à l'ancienne image de l'élément, car la nouvelle image n'existe pas.

Vous pouvez contrôler le résultat d'une exportation filtrée à l'aide de trois types d'expressions. Vous pouvez fournir l'un d'entre eux ou les combiner dans une seule demande d'exportation :

  • Une expression de condition clé sélectionne des éléments en fonction de leur clé primaire, en utilisant la même syntaxe et les mêmes règles qu'une expression de condition clé Query DynamoDB. Une expression de condition clé spécifie une valeur de clé de partition unique avec une comparaison d'égalité et une condition facultative sur la clé de tri. Il ne peut pas faire référence à des attributs non clés et ne peut pas spécifier plus d'une valeur de clé de partition. Comme une expression de condition clé limite l'exportation à une seule valeur de clé de partition, elle réduit la quantité de données que DynamoDB lit pour l'exportation. Pour plus d’informations, consultez Expressions de condition clé pour l’opération Query dans DynamoDB.

  • Une expression de filtre peut appliquer des conditions à la fois aux attributs clés et non clés, en utilisant la même syntaxe et les mêmes règles qu'une expression de filtre dans une Scan opération. Les expressions de filtre prennent en charge les comparaisons telles que « égal »OR, « non égal » et containsIN, avec les size fonctions begins_withBETWEEN,attribute_exists,,, et. DynamoDB applique une expression de filtre après avoir lu les données, afin que le filtre ne réduise pas la quantité de données traitées par DynamoDB pour l'exportation. Pour plus d'informations sur les expressions de filtre et leur syntaxe, consultezSyntaxe des expressions de filtre et de condition.

  • Une expression de projection identifie les attributs spécifiques que vous souhaitez voir apparaître dans la sortie d'exportation, en utilisant la même syntaxe et les mêmes règles qu'une expression de projection dans d'autres opérations DynamoDB. Pour plus d’informations, consultez Utilisation d’expressions de projection dans DynamoDB.

Note

L'affichage d'un attribut clé dans l'expression du filtre dépend du fait que vous fournissez également une expression de condition clé. Si vous fournissez une expression de condition clé, l'attribut clé ne peut pas également apparaître dans l'expression de filtre. Si vous ne fournissez qu'une expression de filtre, les attributs clés peuvent apparaître dans l'expression de filtre.

Chaque expression est soumise aux limites suivantes :

  • La taille d'une expression peut atteindre 4 Ko.

  • Les noms d'attributs peuvent contenir jusqu'à 250 octets.

  • Les valeurs d'attribut peuvent atteindre 2 Mo.

  • Une expression peut contenir au maximum 300 opérateurs.