如何为DynamoDB订单表配置GSI实现按status筛选的高效Query查询

DynamoDB的Query操作只能针对主键、或者二级索引的键属性执行，你没办法直接对普通属性status发起Query请求，所以需要先配置全局二级索引（GSI），再基于GSI做查询，具体步骤如下： #

1. 新增status作为分区键的全局二级索引 #

进入DynamoDB控制台的订单表配置页，新建全局二级索引：

• 索引分区键设置为status，类型匹配你现有status的属性类型（一般为字符串）
• 可选配置：如果同状态下的订单需要按创建时间、订单金额等维度排序，可以加对应字段作为该索引的排序键
• 投影属性配置：按需选择即可，只需要部分字段返回就选「指定属性」，要全量字段选「全部」，追求最低读取成本选「仅键属性」
• 按你的业务流量配置索引的读写容量即可，用按需付费模式的话可以不用手动设置

2. 基于GSI执行Query查询 #

不同语言的SDK写法逻辑一致，以下为Python boto3的示例代码：

import boto3

dynamodb = boto3.resource('dynamodb')
order_table = dynamodb.Table('你的订单表名称')

# 示例：查询所有状态为已支付的订单
resp = order_table.query(
    # 指定你刚才创建的GSI的索引名称
    IndexName='status-index',
    # status是DynamoDB保留字，需要用别名替换
    KeyConditionExpression='#st = :target_status',
    ExpressionAttributeNames={
        '#st': 'status'
    },
    ExpressionAttributeValues={
        ':target_status': 'PAID' # 替换为你要筛选的状态值
    }
)

# 筛选后的订单列表
order_list = resp['Items']

注意事项 #

• 如果你的订单状态枚举值非常少（比如只有3-5种固定状态），且某类状态的订单量级特别大，会出现GSI分区键热度不均的问题，建议将分区键改为status#日期的拼接值，查询时按日期拆分请求，分散分区压力
• 全局二级索引默认是最终一致性，如果你的业务要求强一致性读，不能用GSI，小数据量场景下可以继续用Scan加FilterExpression实现
• 对比原全表Scan方案，GSI+Query的查询延迟和读写成本都会大幅降低，表数据量越大收益越明显

内容的提问来源于stack exchange，提问作者Prasad