如何基于DynamoDB单表设计建模带局部唯一外部ID的Response实体

背景 #

• 平台支持用户创建Panel用于招募科研参与者
• 每个Panel可生成多个Request，发送给外部Provider执行招募
• Provider返回的响应数据包含external_response_id、panel_request_id和panel_id

核心约束与访问模式 #

约束 #

• external_response_id仅在对应panel_request_id范围内唯一，无全局唯一性
• 需支持两种查询：
  1. 通过external_response_id查询Response
  2. 通过系统内部生成的response_id查询Response

Response实体逻辑字段 #

建模实现方案 #

主表主键设计（满足内部ID查询） #

将主表的**分区键（PK）**设为固定前缀+内部ID，**排序键（SK）**固定为实体类型标识：

• PK: RESPONSE#<id>
• SK: RESPONSE

通过内部id查询时，直接指定PK = RESPONSE#<目标id>即可快速定位单条数据，符合DynamoDB单点查询的高效特性。

GSI设计（满足external_id查询） #

针对external_id仅在request_id范围内唯一的特性，设计全局二级索引（GSI），利用拼接键实现唯一约束与高效查询：

• GSI的分区键（GSI1PK）: REQUEST#<request_id>
• GSI的排序键（GSI1SK）: EXTERNAL_RESPONSE#<external_id>

同时在GSI中投影所有Response字段（或按需投影核心字段），确保查询时无需回表。

实体完整存储结构示例 #

{
  "PK": "RESPONSE#abc123-uuid-456",
  "SK": "RESPONSE",
  "id": "abc123-uuid-456",
  "source": "panel",
  "panel_id": "PANEL#001",
  "request_id": "REQUEST#001",
  "external_id": "ext_resp_789",
  "GSI1PK": "REQUEST#001",
  "GSI1SK": "EXTERNAL_RESPONSE#ext_resp_789"
}

访问模式验证 #

1. 通过内部id查询：执行GetItem操作，指定PK = RESPONSE#<目标id>、SK = RESPONSE，单次请求即可获取数据。
2. 通过external_id查询：先获取对应request_id（业务上下文可直接获取，或结合panel_id关联查询），然后在GSI上执行Query操作，指定GSI1PK = REQUEST#<目标request_id>且GSI1SK = EXTERNAL_RESPONSE#<目标external_id>，精准定位唯一数据。

扩展性补充 #

如果业务需要按panel_id批量查询该Panel下所有Response，可额外添加一个GSI：

• GSI2PK: PANEL#<panel_id>
• GSI2SK: RESPONSE#<id>
  支持按Panel批量检索Response，适配更多业务场景。

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