Referencia a atributos de elementos mediante expresiones en DynamoDB

En esta sección se describe cómo consultar los atributos de los elementos en una expresión en Amazon DynamoDB. Puede utilizar cualquier atributo, aunque se encuentre anidado profundamente en varias listas y mapas.

Ejemplo de elemento: ProductCatalog

Los ejemplos de esta página utilizan el siguiente elemento de muestra de la tabla de ProductCatalog. Esta tabla se describe en Tablas y datos de ejemplo para usar en 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"
 }

Tenga en cuenta lo siguiente:

Atributos de nivel superior

Se considera que un atributo es de nivel superior si no está integrado en otro atributo. En el elemento ProductCatalog, los atributos de nivel superior son:

Todos estos atributos de nivel superior son escalares, con la salvedad de Color (lista), RelatedItems (lista), Pictures (mapa) y ProductReviews (mapa).

Atributos anidados

Se considera que un atributo es anidado si está integrado en otro atributo. Para obtener acceso a un atributo anidado, se utilizan los operadores de desreferenciación:

Acceso a los elementos de la lista

El operador de desreferencia de un elemento de la lista es [N], donde n es el número del elemento. Las entradas de lista están basadas en cero; es decir, [0] representa la primera entrada de la lista, [1] representa la segunda, y así sucesivamente. Estos son algunos ejemplos:

La entrada ThisList[5] es una lista anidada en sí misma. Por consiguiente, ThisList[5][11] se refiere al duodécimo componente de esa lista.

El número contenido entre corchetes debe ser un entero no negativo. Por lo tanto, las siguientes expresiones no son válidas:

Acceso a los elementos de un mapa

El operador de desreferenciación de una entrada de un mapa es . (un punto). Utilice el punto como separador entre las entradas de un mapa:

Rutas de documento

En una expresión, se utiliza una ruta de documento para indicar a DynamoDB dónde se encuentra un atributo. En el caso de un atributo de nivel superior, la ruta de documento es el nombre de atributo. En el caso de un atributo anidado, se utilizan operadores de desreferenciación para construir la ruta de documento.

A continuación se indican algunos ejemplos de rutas de documentos. Consulte el elemento mostrado en Referencia a atributos de elementos mediante expresiones en DynamoDB.

Puede utilizar cualquier nombre de atributo en la ruta de un documento siempre que cumpla estos requisitos:

Para obtener más información, consulte Nombres de atributos de expresión (Alias) en DynamoDB.