Referir-se a atributos de item ao usar expressões no DynamoDB

Esta seção descreve como consultar atributos de item em uma expressão no Amazon DynamoDB. Você pode trabalhar com qualquer atributo, mesmo se ele estiver profundamente aninhado dentro de várias listas e mapas.

Um item de exemplo: ProductCatalog

Os exemplos desta página usam o item de amostra a seguir na tabela ProductCatalog. (Esta tabela é descrita na seção Exemplos de tabelas e dados para uso no 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"
 }

Observe o seguinte:

Atributos de nível superior

Um atributo será considerado como de nível superior se ele não estiver incorporado a outro atributo. Para o item do ProductCatalog, os atributos de nível superior são os seguintes:

Todos esses atributos de nível superior são escalares, exceto Color (lista), RelatedItems (lista), Pictures (mapa) e ProductReviews (mapa).

Atributos aninhados

Um atributo é considerado aninhado se ele estiver incorporado a outro atributo. Para acessar um atributo aninhado, utiliza-se operadores de cancelamento de referência:

Acesso a elementos de lista

O operador de desreferência de um elemento de lista é [N], onde n é o número do elemento. Os elementos de lista são baseados em zero, portanto, [0] representa o primeiro elemento na lista, [1] representa o segundo, e assim por diante. Veja alguns exemplos:

O próprio elemento ThisList[5] é uma lista aninhada. Portanto, ThisList[5][11] refere-se ao décimo segundo elemento na lista.

O número dentro de colchetes deve ser um inteiro não negativo. Portanto, as seguintes expressões são inválidas:

Acessar elementos de mapas

O operador de cancelamento de referência de um elemento de mapa é . (um ponto). Use um ponto como um separador entre os elementos em um mapa:

Caminhos de documentos

Em uma expressão, você usa um caminho de documento para informar ao DynamoDB onde encontrar um atributo. Para um atributo de nível superior, o caminho do documento é simplesmente o nome do atributo. Para um atributo aninhado, você pode construir o caminho do documento usando operadores de cancelamento de referência.

Veja a seguir alguns exemplos de caminhos de documentos. (Consulte o item mostrado em Referir-se a atributos de item ao usar expressões no DynamoDB.)

É possível usar qualquer nome de atributo em um caminho de documento, desde ele que cumpra estes requisitos:

Para ter mais informações, consulte Nomes (aliases) de atributo de expressão no DynamoDB.