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.

Référencement d’attributs d’élément lors de l’utilisation d’expressions dans DynamoDB

Cette section décrit comment référencer des attributs d’élément dans une expression dans Amazon DynamoDB. Vous pouvez utiliser tout attribut, même s’il est profondément imbriqué dans plusieurs listes et mappages.

Un exemple d'article : ProductCatalog

Les exemples sur cette page utilisent l’exemple d’élément suivant dans la table ProductCatalog. (Cette table est décrite dans Exemples de tables et de données à utiliser dans DynamoDB.)

{
    "Id": 123,
    "Title": "Bicycle 123",
    "Description": "123 description",
    "BicycleType": "Hybrid",
    "Brand": "Brand-Company C",
    "Price": 500,
    "Color": ["Red", "Black"],
    "ProductCategory": "Bicycle",
    "InStock": true,
    "QuantityOnHand": null,
    "RelatedItems": [
        341,
        472,
        649
    ],
    "Pictures": {
        "FrontView": "http://example.com/products/123_front.jpg",
        "RearView": "http://example.com/products/123_rear.jpg",
        "SideView": "http://example.com/products/123_left_side.jpg"
    },
    "ProductReviews": {
	    "FiveStar": [
	    		"Excellent! Can't recommend it highly enough! Buy it!",
	    		"Do yourself a favor and buy this."
	    ],
	    "OneStar": [
	    		"Terrible product! Do not buy this."
	    ]
    },
    "Comment": "This product sells out quickly during the summer",
    "Safety.Warning": "Always wear a helmet"
 }

Notez ce qui suit :

Attributs de niveau supérieur

Un attribut est dit de niveau supérieur lorsqu’il n’est pas imbriqué dans un autre. Dans le cas de l’élément ProductCatalog, voici les attributs de niveau supérieur :

Tous ces attributs de niveau supérieur sont scalaires, à l’exception de Color (liste), RelatedItems (liste), Pictures (mappage) et ProductReviews (mappage).

Attributs imbriqués

Un attribut est dit imbriqué lorsqu’il est incorporé dans un autre. Accédez à un attribut imbriqué à l’aide d’opérateurs de déréférençage :

Accès à des éléments de liste

L’opérateur de déréférençage pour un élément de liste est [n], où n est le numéro d’élément. Des éléments de liste sont de base zéro, donc [0] représente le premier élément dans la liste, [1] représente le deuxième et ainsi de suite. Voici quelques exemples :

L’élément ThisList[5] est lui-même une liste imbriquée. Par conséquent, ThisList[5][11] fait référence au douzième élément dans cette liste.

Le nombre entre crochets doit être un nombre entier non négatif. Par conséquent, les expressions suivantes ne sont pas valides :

Accès à des éléments de mappage

L’opérateur de déréférençage pour un élément de mappage est . (un point). Utilisez un point comme séparateur entre des éléments d’un mappage :

Chemins d’accès à des documents

Dans une expression, vous indiquez à DynamoDB où trouver un attribut à l’aide d’un chemin d’accès à un document. Pour un attribut de niveau supérieur, le chemin d’accès au document est simplement le nom d’attribut. Pour un attribut imbriqué, vous construisez le chemin d’accès au document à l’aide d’opérateurs de déréférençage.

Voici quelques exemples d’expressions de chemins d’accès à des documents. (Consultez l’élément présenté dans Référencement d’attributs d’élément lors de l’utilisation d’expressions dans DynamoDB.)

Vous pouvez utiliser tout nom d’attribut dans le chemin d’accès à un document, à condition qu’il réponde aux exigences suivantes :

Pour de plus amples informations, veuillez consulter Noms d’attributs d’expression (alias) dans DynamoDB.