如何为Property_Id、Category_Id、SubCategory_Id设计DynamoDB复合主键表

需求背景 #

我正在设计存储房产数据的DynamoDB表，每个房产归属一个分类与子分类，需要实现基于Property_Id、Category_Id和SubCategory_Id的高效查询。现有属性如下：

Property_Id (bigint)
Category_Id (int)
SubCategory_Id (int)

原建表命令与错误 #

原建表命令 #

aws dynamodb create-table \
--table-name orders_table \
--attribute-definitions AttributeName=Property_Id,AttributeType=N AttributeName=Category_Id,AttributeType=N AttributeName=country_code,AttributeType=N AttributeName=SubCategory_Id,AttributeType=N AttributeName=order_date,AttributeType=S \
--key-schema AttributeName=Property_Id,KeyType=HASH AttributeName=Category_Id,KeyType=HASH AttributeName=SubCategory_Id,KeyType=RANGE \
--provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
--global-secondary-indexes IndexName=OrderDateIndex,KeySchema=[{AttributeName=order_date,KeyType=HASH}],Projection={ProjectionType=ALL},ProvisionedThroughput={ReadCapacityUnits=5,WriteCapacityUnits=5} \
--region us-east-1

错误信息 #

调用CreateTable操作时发生错误(ValidationException)：检测到1个验证错误：'keySchema'处的值'[KeySchemaElement(attributeName=Property_Id, keyType=HASH), KeySchemaElement(attributeName=Category_Id, keyType=HASH), KeySchemaElement(attributeName=SubCategory_Id, keyType=RANGE)]'未满足约束条件：成员长度必须小于或等于2

核心问题说明 #

DynamoDB的表主键只能是1个分区键（HASH） + 0或1个排序键（RANGE），不允许设置多个分区键，这是报错的直接原因。需要根据实际查询场景设计主键和索引，以下是几种常见场景的解决方案：

解决方案 #

场景1：优先通过Property_Id查询单条房产，同时支持分类/子分类批量查询 #

• 表主键设计：
  • 分区键（HASH）：Property_Id（唯一标识单条房产，保证单条查询效率）
  • 排序键（RANGE）：SubCategory_Id（可选，用于同房产下的子分类排序，不需要可省略）
• 全局二级索引（GSI）：创建CategorySubCategoryIndex，用于快速查询指定分类+子分类下的所有房产
  • 分区键：Category_Id
  • 排序键：SubCategory_Id
  • 投影所有属性，确保查询时能获取完整数据

修正后的建表命令：

aws dynamodb create-table \
--table-name property_table \
--attribute-definitions \
  AttributeName=Property_Id,AttributeType=N \
  AttributeName=Category_Id,AttributeType=N \
  AttributeName=SubCategory_Id,AttributeType=N \
  AttributeName=order_date,AttributeType=S \
--key-schema \
  AttributeName=Property_Id,KeyType=HASH \
  AttributeName=SubCategory_Id,KeyType=RANGE \
--provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
--global-secondary-indexes \
  "IndexName=CategorySubCategoryIndex,KeySchema=[{AttributeName=Category_Id,KeyType=HASH},{AttributeName=SubCategory_Id,KeyType=RANGE}],Projection={ProjectionType=ALL},ProvisionedThroughput={ReadCapacityUnits=5,WriteCapacityUnits=5}" \
  "IndexName=OrderDateIndex,KeySchema=[{AttributeName=order_date,KeyType=HASH}],Projection={ProjectionType=ALL},ProvisionedThroughput={ReadCapacityUnits=5,WriteCapacityUnits=5}" \
--region us-east-1

场景2：优先通过分类/子分类批量查询房产，同时支持Property_Id单条查询 #

• 表主键设计：
  • 分区键（HASH）：Category_Id
  • 排序键（RANGE）：SubCategory_Id（将同分类下的子分类房产聚合在一起，提升批量查询效率）
• 全局二级索引（GSI）：创建PropertyIdIndex，用于快速查询单条房产数据
  • 分区键：Property_Id
  • 投影所有属性

修正后的建表命令：

aws dynamodb create-table \
--table-name property_table \
--attribute-definitions \
  AttributeName=Property_Id,AttributeType=N \
  AttributeName=Category_Id,AttributeType=N \
  AttributeName=SubCategory_Id,AttributeType=N \
  AttributeName=order_date,AttributeType=S \
--key-schema \
  AttributeName=Category_Id,KeyType=HASH \
  AttributeName=SubCategory_Id,KeyType=RANGE \
--provisioned-throughput ReadCapacityUnits=5,WriteCapacityUnits=5 \
--global-secondary-indexes \
  "IndexName=PropertyIdIndex,KeySchema=[{AttributeName=Property_Id,KeyType=HASH}],Projection={ProjectionType=ALL},ProvisionedThroughput={ReadCapacityUnits=5,WriteCapacityUnits=5}" \
  "IndexName=OrderDateIndex,KeySchema=[{AttributeName=order_date,KeyType=HASH}],Projection={ProjectionType=ALL},ProvisionedThroughput={ReadCapacityUnits=5,WriteCapacityUnits=5}" \
--region us-east-1

场景3：需要支持多种组合查询（如Property_Id+Category_Id、Category_Id+Property_Id等） #

如果查询模式灵活多样，可以提前规划常用的查询组合，通过创建多个GSI覆盖。例如：

• 表主键：Property_Id（HASH） + Category_Id（RANGE）（支持按Property_Id查询，或Property_Id+Category_Id组合查询）
• GSI1：Category_Id（HASH） + SubCategory_Id（RANGE）（支持分类+子分类批量查询）
• GSI2：Property_Id（HASH） + SubCategory_Id（RANGE）（支持Property_Id+SubCategory_Id组合查询）

这种方式需要权衡索引数量和存储成本，避免创建过多冗余索引。

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