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érence aux attributs des éléments lors de l'utilisation d'expressions dans DynamoDB

Cette section décrit comment faire référence à des attributs d'élément dans une expression dans Amazon DynamoDB. Vous pouvez utiliser n'importe quel attribut, même s'il est profondément imbriqué dans plusieurs listes et cartes.

Un exemple d'article : ProductCatalog

Les exemples de cette page utilisent l'exemple d'élément suivant dans le ProductCatalog tableau. 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 attribut. Dans le cas de l'élément ProductCatalog, les attributs de niveau supérieur sont les suivants :

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

Attributs imbriqués

Un attribut est dit imbriqué lorsqu'il est incorporé dans un autre attribut. Pour accéder à un attribut imbriqué, utilisez des 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 :

Pour accéder aux éléments de la map

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

Chemins d'accès du document

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

Voici quelques exemples d'expressions de chemins d'accès à un document. Reportez-vous à l'élément présenté dans Référence aux attributs des éléments lors de l'utilisation d'expressions dans DynamoDB.

Vous pouvez utiliser n'importe quel nom d'attribut dans le chemin d'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.