DynamoDB で式を使用する場合の項目属性の参照

このセクションでは、Amazon DynamoDB で式の項目属性を参照する方法を説明します。複数のリストやマップ内で深くネストされている場合でも、属性を使用できます。

サンプル項目: ProductCatalog

このページの例では、ProductCatalog テーブルで次のサンプル項目を使用しています (このテーブルについては、「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"
 }

次の点に注意してください。

最上位属性

属性が別の属性に組み込まれていない場合、最上位属性と呼ばれます。ProductCatalog 項目の最上位属性は次のようになります。

Color (リスト)、RelatedItems (リスト)、Pictures (マップ)、および ProductReviews (マップ) を除くすべての最上位属性はスカラーです。

入れ子の属性

属性が別の属性に組み込まれている場合、入れ子の属性と呼ばれます。入れ子の属性にアクセスするには、間接参照演算子を使用します。

リスト要素へのアクセス

リスト要素の間接参照演算子は N で、n は要素数です。リストの要素はゼロベースであるため、[0] はリスト内の最初の要素、[1] は 2 番目の要素、という順番で表されます。次に例を示します。

要素 ThisList[5] は、それ自体がネストされたリストです。したがって、ThisList[5][11] は、そのリストの 12 番目の要素を参照します。

角括弧内の数は、負以外の整数である必要があります。そのため、次の式は無効です。

マップ要素へのアクセス

マップ要素の間接参照演算子は . (ドット) です。マップの要素間の区切り文字として、ドットを使用します。

ドキュメントパス

式では、ドキュメントパスを使用して、属性の場所を DynamoDB に伝えます。最上位属性の場合、ドキュメントパスは単純に属性名になります。ネストされた属性の場合は、間接参照演算子を使用してドキュメントパスを構築します。

ドキュメントパスのいくつかの例を次に示します。(DynamoDB で式を使用する場合の項目属性の参照 に示された項目を参照してください)

次の要件を満たしている限り、ドキュメントパスには任意の属性名を使用できます。

詳細については、「DynamoDB の式の属性名 (エイリアス)」を参照してください。