投影表达式 - Amazon DynamoDB
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

投影表达式

要从表中读取数据,您可以使用GetItemQuery,或者Scan。默认情况下,Amazon DynamoDB 会返回所有商品属性。要仅获取部分属性而不是全部属性,请使用投影表达式。

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

以下是基于ProductCatalog商品来自使用表达式时指定项目属性

  • 单个顶级属性。

    Title

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

    Title, Price, Color

  • 四个顶级属性。DynamoDB 返回RelatedItemsProductReviews

    Title, Description, RelatedItems, ProductReviews

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

以下 AWS CLI 示例说明如何使用带GetItemoperation. 此投影表达式检索顶级标量属性 (Description),列表中的第一个元素(RelatedItems[0])和嵌套在地图中的列表(ProductReviews.FiveStar)。

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

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

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

有关编程语言特定的代码示例,请参阅开始使用 DynamoDB 和 AWS 开发工具包