本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 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] 代表第二個，以此類推。以下是一些範例：

元素 ThisList[5] 本身是巢狀清單。因此，ThisList[5][11] 是指該清單中的第 12 個元素。

方括號內的數字必須是非負整數。因此，下列表達式無效：

存取映射元素

映射元素的取消參考運算子為 . (點號)。請在映射中的元素之間使用點號做為分隔符號：

文件路徑

在表達式中，您可以使用文件路徑指示 DynamoDB 要在何處尋找屬性。針對最上層屬性，文件路徑就是屬性名稱。針對巢狀屬性，您可以使用取消參考運算子來建構文件路徑。

以下是文件路徑的一些範例 (請參閱 在 DynamoDB 中使用表達式時參考項目屬性 中所示的項目。)

您可以在文件路徑中使用任何屬性名稱，只要名稱符合下列要求：

如需詳細資訊，請參閱DynamoDB 中的表達式屬性名稱 （別名）。