使用 AWS CLI 查询 DynamoDB GSI

查询一个全局二级索引就是一次普通的 aws dynamodb query 加上一个标志：--index-name。键条件随即针对索引的键，而非表的键——这里 AlbumTitle-index 让我们能按专辑获取歌曲，而基表（Artist + SongTitle）不做扫描就无法服务这种访问模式。

Code

aws dynamodb query \
  --table-name 'Music' \
  --index-name 'AlbumTitle-index' \
  --key-condition-expression '#hashKey = :hashKeyValue' \
  --expression-attribute-names '{"#hashKey":"AlbumTitle"}' \
  --expression-attribute-values '{":hashKeyValue":{"S":"Danzon"}}'

输出是以 DynamoDB JSON 表示的匹配项目：

{
    "Items": [
        {"Artist": {"S": "Arturo Sandoval"}, "SongTitle": {"S": "Cubano Chant"}, ...}
    ],
    "Count": 2,
    "ScannedCount": 2
}

说明

--index-name — 指定要查询的 GSI（--table-name 仍然必需）。--key-condition-expression 使用索引的分区键（以及可选的排序键）——这里是 AlbumTitle——运算符与表查询相同。
仅最终一致性 — GSI 从基表异步复制。给 GSI 查询加上 --consistent-read 并不会将其升级；它会以 ValidationException 失败。（本地二级索引确实支持强一致性。）
你只得到被投影的属性 — 一次 GSI 查询返回索引所投影的内容（ALL、KEYS_ONLY 或 INCLUDE 列出的属性），且不能从基表获取其余部分。
GSI 中的键不唯一 — 许多项目可以共享同一个索引键，而缺少该索引键属性的项目根本不会出现（这就是稀疏索引模式）。
分页是自动的 — CLI 在幕后跟随服务的分页令牌并打印合并后的结果。用 --max-items 限制输出（会出现一个 NextToken；用 --starting-token 续读），或用 --no-paginate 做单次服务调用。

可视化操作

DynamoDB Expression Builder 会为索引查询构建键条件 + 名称/值映射，并交给你一条可直接运行的 CLI 命令。

想浏览一张表的索引并用表单运行 GSI 查询——分页网格、复制为 CLI——请下载 DynoTable。

References

Last verified 2026-07-13 against the official AWS documentation linked above.

使用 AWS CLI 查询 DynamoDB GSI

Code

说明

可视化操作

相关示例

References

可视化构建此请求