本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
处理本地二级索引:AWS CLI
您可以使用 AWS CLI 创建具有一个或多个本地二级索引的 Amazon DynamoDB 表、描述表上的索引,以及使用索引执行查询。
创建含有本地二级索引的表
本地二级索引必须在您创建表的同时创建。为此,请使用 create-table
参数并提供一个或多个本地二级索引的规范。以下示例创建一个表 (Music
) 来保存有关音乐精选中的歌曲的信息。分区键为 Artist
,排序键为 SongTitle
。 属性上的二级索引 AlbumTitleIndex
有助于按专辑标题进行查询。AlbumTitle
aws dynamodb create-table --table-name Music \ --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \ AttributeName=AlbumTitle,AttributeType=S \ --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \ --provisioned-throughput \ ReadCapacityUnits=10,WriteCapacityUnits=5 \ --local-secondary-indexes \ "[{\"IndexName\": \"AlbumTitleIndex\", \"KeySchema\":[{\"AttributeName\":\"Artist\",\"KeyType\":\"HASH\"}, {\"AttributeName\":\"AlbumTitle\",\"KeyType\":\"RANGE\"}], \"Projection\":{\"ProjectionType\":\"INCLUDE\", \"NonKeyAttributes\":[\"Genre\", \"Year\"]}}]"
您必须等待 DynamoDB 创建表并将表状态设置为 ACTIVE
。 之后,您就可以开始将数据项目放入表中了。您可以使用 describe-table 确定表创建的状态。
描述含有本地二级索引的表
要获取有关表上本地二级索引的信息,请使用 describe-table
参数。对于每个索引,您都可以查看其名称、键架构和投影的属性。
aws dynamodb describe-table --table-name Music
查询本地二级索引
您可以对local secondary index使用 query
操作(基本与对表执行 query
操作一样)。您需要指定索引名称、索引排序键的查询条件以及要返回的属性。在本示例中,索引为 AlbumTitleIndex
,索引排序键为 AlbumTitle
。
要返回的只包含投影到索引的属性。您也可以修改此查询,让返回结果中也包含非键属性,但是这样会导致表抓取活动的成本相对较高的。有关表抓取的更多信息,请参阅属性投影。
aws dynamodb query --table-name Music \ --index-name AlbumTitleIndex \ --key-condition-expression "Artist = :v_artist and AlbumTitle = :v_title" \ --expression-attribute-values '{":v_artist":{"S":"Acme Band"},":v_title":{"S":"Songs About Life"} }'