View a markdown version of this page

Projections - AWS AppSync GraphQL

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.

Projections

Lorsque vous lisez des objets dans DynamoDB à l'aide des TransactGetItems opérations GetItem Scan QueryBatchGetItem,,, et, vous pouvez éventuellement spécifier une projection qui identifie les attributs souhaités. La structure de la propriété de projection est la suivante, similaire à celle des filtres :

type DynamoDBExpression = { expression: string; expressionNames?: { [key: string]: string} };

Les champs sont définis comme suit :

expression

L'expression de projection, qui est une chaîne. Pour récupérer un seul attribut, spécifiez son nom. Pour les attributs multiples, les noms doivent être des valeurs séparées par des virgules. Pour plus d'informations sur l'écriture d'expressions de projection, consultez la documentation sur les expressions de projection DynamoDB. Ce champ est obligatoire.

expressionNames

Les substitutions des espaces réservés aux noms des attributs d'expression sous la forme de paires clé-valeur. La clé correspond à un espace réservé de nom utilisé dans le expression. La valeur doit être une chaîne correspondant au nom d'attribut de l'élément dans DynamoDB. Ce champ est facultatif et ne doit être renseigné qu'avec des substitutions pour les espaces réservés aux noms d'attributs d'expression utilisés dans le. expression Pour plus d'informationsexpressionNames, consultez la documentation de DynamoDB.

Exemple 1

L'exemple suivant est une section de projection pour une JavaScript fonction dont seuls les attributs author id sont renvoyés par DynamoDB :

projection : { expression : "#author, id", expressionNames : { "#author" : "author" } }
Astuce

Vous pouvez accéder à votre ensemble de sélection de requêtes GraphQL à l'aide de la sélection SetList. Ce champ vous permet de cadrer dynamiquement l'expression de votre projection en fonction de vos besoins.

Note

Lorsque vous utilisez des expressions de projection avec les Scan opérations Query et, la valeur de select doit êtreSPECIFIC_ATTRIBUTES. Pour plus d'informations, consultez la documentation DynamoDB.