如何创建带复合排序键的DynamoDB全局二级索引(GSI)

报错根因 #

你碰到的

Global Secondary Index range key not specified in Attribute Definitions.Type unknown.
报错，核心原因是DynamoDB不会自动将多个字段拼接生成复合排序键，创建GSI时要求所有作为索引键的字段必须提前在属性定义中明确声明，你直接把拼接表达式Type#Total_value#Created_at作为排序键字段传入，系统识别不到这个真实存在的字段，就会抛出类型未知的错误。

复合拼接排序键的设计思路本身是可行的，但需要按DynamoDB的规则调整实现逻辑。

具体操作步骤 #

1. 新增专用复合排序键字段 #

在订单表中新增一个字符串类型（S）的字段，比如命名为GSI_Order_SortKey，专门用来存储拼接后的复合排序值，不要直接用拼接表达式当字段名。

拼接值时必须做格式标准化，避免字符串排序逻辑错乱：

• 数值类的Total_Value要补前导零统一长度，比如将数值199处理为00000199，防止字符串排序时出现"99"大于"100"的问题
• 时间类的Created_at统一用毫秒级Unix时间戳或者ISO标准时间格式存储，保证时间顺序正确
• 固定拼接规则为{Type}#{格式对齐后的Total_Value}#{标准格式Created_at}，分隔符统一用#，不要随意变更拼接顺序

2. 按规则配置GSI参数 #

创建GSI时不要传入拼接表达式，按如下配置填写参数即可解决报错：

• GSI分区键：选择表中已存在的Product_name字段，类型为字符串（S）
• GSI排序键：选择你新增的GSI_Order_SortKey字段，类型为字符串（S）
• 在属性定义板块，必须把Product_name、GSI_Order_SortKey两个索引键字段加入定义列表，字段类型和实际存储类型保持一致

3. 匹配业务查询逻辑 #

GSI创建完成后，你需要的所有查询能力都可以覆盖：

• 按Product_name查询全量订单：查询时指定GSI，仅传入分区键为目标商品名，即可扫描出该商品下的所有订单
• 按Type过滤：查询时增加排序键的begins_with条件，传入值为目标Type#，即可过滤出该商品下对应类型的订单
• 按Total_Value、Created_at排序：DynamoDB默认会按排序键的UTF-8编码顺序返回结果，只要你提前做了数值和时间的格式对齐，返回结果天然按Total_Value升序、同金额下按Created_at升序排列；需要倒序时，查询时将ScanIndexForward参数设为false即可

注意事项 #

所有写入、更新主表订单数据的操作，都必须同步计算对应GSI_Order_SortKey的值和其他字段一起写入。如果某条订单数据的GSI_Order_SortKey字段为空，这条数据不会同步到GSI中，查询时会出现数据遗漏。

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