Amazon DynamoDB
开发人员指南 (API Version 2012-08-10)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

投影表达式

要从表中读取数据,您可使用 GetItemQueryScan 等操作。DynamoDB 默认情况下返回所有项目属性。要获取部分而非全部属性,请使用投影表达式。

投影表达式是用于标识您需要的属性的字符串。要检索单个属性,请指定其名称。对于多个属性,必须使用逗号分隔名称。

下面是投影表达式 (基于指定项目属性中的 ProductCatalog 项目) 的一些示例:

  • 单个顶级属性。

    Title

  • 三个顶级属性。DynamoDB 将检索整个 Color 集。

    Title, Price, Color

  • 四个顶级属性。DynamoDB 将返回 RelatedItemsProductReviews 的全部内容。

    Title, Description, RelatedItems, ProductReviews

您可以在投影表达式中使用任意属性名称,前提是第一个字符是 a-zA-Z,第二个字符(如果存在)是 a-zA-Z0-9。如果属性名称不满足此要求,则需要将表达式属性名称定义为占位符。有关更多信息,请参阅 表达式属性名称

以下 AWS CLI 示例将展示如何将投影表达式与 GetItem 操作一起使用。此投影表达式将检索顶级标量属性 (Description)、列表中的第一个元素 (RelatedItems[0]) 以及映射中嵌套的列表 (ProductReviews.FiveStar)。

Copy
aws dynamodb get-item \ --table-name ProductCatalog \ --key file://key.json \ --projection-expression "Description, RelatedItems[0], ProductReviews.FiveStar"

--key 的参数存储在文件 key.json 中:

Copy
{ "Id": { "N": "123" } }

有关编程语言特定代码示例,请参阅 Amazon DynamoDB 入门指南