dynamodb 的 getitem 操作只能根据完整主键（分区键+排序键）精确获取单条记录；若需通过分区键查询多条数据，必须使用 query 操作，并确保表结构支持（即分区键唯一、排序键存在），本文详解实现方法及注意事项。
dynamodb 的 getitem 操作只能根据完整主键（分区键+排序键）精确获取单条记录；若需通过分区键查询多条数据，必须使用 query 操作，并确保表结构支持（即分区键唯一、排序键存在），本文详解实现方法及注意事项。
在 DynamoDB 中，GetItem 仅适用于已知完整主键（Partition Key + Sort Key）的场景，返回至多一条记录。而你的表结构为：分区键 DeviceId（String）+ 排序键 Time（Number），这意味着同一 DeviceId 下可能对应多条按时间排序的记录。此时若想获取该设备的所有历史数据，GetItem 无法满足需求——它缺少对“范围匹配”或“批量检索”的支持。
正确的方式是使用 Query 操作。Query 专为高效检索同一分区键下的多条记录而设计，它要求：
- 表必须定义复合主键（即含 Sort Key）；
- 查询条件必须包含且仅包含 Partition Key 的等值匹配（EQ），可选添加 Sort Key 的范围条件（如 BETWEEN、BEGINS_WITH 等）。
以下是 Go 语言中使用 aws-sdk-go 执行 Query 的标准示例：
queryInput := &dynamodb.QueryInput{
TableName: aws.String("DbName"),
KeyConditionExpression: aws.String("DeviceId = :deviceId"),
ExpressionAttributeNames: map[string]*string{
"#device": "DeviceId", // 避免关键词冲突，推荐使用表达式名称
},
ExpressionAttributeValues: map[string]*dynamodb.AttributeValue{
":deviceId": {
S: aws.String("item_1"),
},
},
}
result, err := svc.Query(queryInput)
if err != nil {
log.Fatalf("Query failed: %v", err)
}
// result.Items 是 []*map[string]*dynamodb.AttributeValue 类型，包含所有匹配项
for _, item := range result.Items {
// 解析并处理每条记录，例如：
deviceId := *item["DeviceId"].S
timestamp := *item["Time"].N
fmt.Printf("Device: %s, Time: %s\n", deviceId, timestamp)
}✅ 关键要点说明：
- ✅ 使用 KeyConditionExpression（推荐）替代已弃用的 KeyConditions，更安全、更灵活；
- ✅ ExpressionAttributeNames 和 ExpressionAttributeValues 支持占位符，避免注入风险与语法冲突；
- ❌ 不要使用 Scan：虽能实现相同效果，但会全表扫描，成本高、性能差，仅当无合适索引时才考虑；
- ⚠️ 注意分页：若结果超过 1MB 或 100 条，默认只返回部分数据，需检查 result.LastEvaluatedKey 并循环调用 Query 实现分页；
- ? 如需按时间范围过滤（如最近 7 天），可在 KeyConditionExpression 中扩展为：
"DeviceId = :deviceId AND #time BETWEEN :start AND :end"，并在 ExpressionAttributeValues 中补充 :start 和 :end。
总之，面对复合主键表，Query 是高效、低成本、符合最佳实践的数据检索方式——请始终优先选用它替代 GetItem 或 Scan 来实现分区键批量查询。
