dynamodb 的 getitem 操作只能通过完整主键（分区键+排序键）精确获取单条记录；若仅知分区键需批量查询，必须改用 query 操作，并确保表结构支持（即排序键存在时 query 可高效检索该分区下所有项）。
dynamodb 的 getitem 操作只能通过完整主键（分区键+排序键）精确获取单条记录；若仅知分区键需批量查询，必须改用 query 操作，并确保表结构支持（即排序键存在时 query 可高效检索该分区下所有项）。
在 AWS DynamoDB 中，当表定义了复合主键（Partition Key + Sort Key）时，GetItem 仅适用于已知完整主键值的场景——它一次只能返回一条匹配记录。你当前的表结构为：分区键 DeviceId（String）和排序键 Time（Number），因此仅提供 DeviceId 无法使用 GetItem 获取多条数据。
✅ 正确做法是使用 Query 操作：它专为基于分区键的高效范围检索设计，可一次性获取指定 DeviceId 下所有相关项（按 Time 升序排列），时间复杂度为 O(1) 分区定位 + O(n) 扫描该分区内数据。
以下是 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)
}
// 遍历结果
for _, item := range result.Items {
// 使用 dynamodbattribute.UnmarshalMap 解析为结构体
var record struct {
DeviceId string `json:"DeviceId"`
Time int64 `json:"Time"`
// 其他字段...
}
if err := dynamodbattribute.UnmarshalMap(item, &record); err != nil {
log.Printf("Unmarshal error: %v", err)
continue
}
fmt.Printf("Found: %+v\n", record)
}
⚠️ 注意事项：
- 勿用 Scan：虽然 Scan 也能过滤 DeviceId，但会全表扫描，吞吐量浪费严重、延迟高、成本高，仅作调试或极小表备用；
- KeyConditionExpression 优先：相比已弃用的 KeyConditions（v1 SDK），新版推荐使用 KeyConditionExpression + ExpressionAttributeNames/Values，语法更安全、灵活且兼容未来版本；
- 排序键自动排序：Query 结果默认按排序键（Time）升序返回，如需降序，添加 ScanIndexForward: aws.Bool(false)；
- 分页处理：若某 DeviceId 下数据量超 1MB 或 100 条，需检查 LastEvaluatedKey 并循环调用，实现分页查询。
综上，面对复合主键表，「仅凭分区键查多条」是 Query 的典型用例——它既符合 DynamoDB 设计哲学，又能保障性能与成本效率。
