如何在DynamoDBContext中加载数据并传入SortKey？

错误原因 #

1. 实体类映射缺失：你的SortKey字段是表的范围键，但未添加[DynamoDBRangeKey]特性，DynamoDBContext无法识别它作为主键的一部分，导致转换时出错。
2. Load方法使用错误：Load<T>()方法用于查询单条唯一记录，需要同时传入哈希键和范围键的完整值。而你只传了哈希键，且原需求是用begins_with匹配范围键前缀，Load方法不支持这种模糊匹配场景。

解决方案 #

1. 修正实体类映射 #

给SortKey添加[DynamoDBRangeKey]特性，确保DynamoDBContext正确识别主键结构：

[DynamoDBTable("vs-configurator-engine-back-table")] // 替换为实际表名
public class MyObject
{
    [DynamoDBHashKey]
    public string HashKey { get; set; }
    
    [DynamoDBRangeKey] // 新增范围键特性
    public string SortKey { get; set; }
    
    [DynamoDBProperty]
    public DateTime activeFrom { get; set; }
    
    [DynamoDBProperty]
    public Guid id { get; set; }
}

2. 使用Query方法实现begins_with查询 #

针对前缀匹配需求，用DynamoDBContext.Query<T>()方法配合QueryOperator.BeginsWith实现和原QueryRequest相同的逻辑，同时自动映射到实体类：

public async Task<DateTime> GetData()
{
    var clientConfig = new AmazonDynamoDBConfig();
    using var client = new AmazonDynamoDBClient(clientConfig);
    using var context = new DynamoDBContext(client);

    var hashKey = "modelyear#specialParam#Id#year#metadata";
    var sortKeyPrefix = "ruleset#";

    // 执行前缀匹配查询
    var queryResult = await context.QueryAsync<MyObject>(
        hashKey,
        QueryOperator.BeginsWith,
        new List<object> { sortKeyPrefix }
    ).GetRemainingAsync();

    // 取第一条结果（和原逻辑一致）
    if (queryResult.Any())
    {
        return queryResult.First().activeFrom;
    }

    // 无数据时的处理，可根据需求调整
    return default;
}

3. 查询单条唯一记录（已知完整SortKey） #

若需查询单条明确记录，可使用LoadAsync<T>()方法，同时传入哈希键和范围键：

var singleObj = await context.LoadAsync<MyObject>(
    "modelyear#specialParam#Id#year#metadata",
    "ruleset#具体规则集ID"
);

关键说明 #

• 使用DynamoDBContext后，查询结果会自动映射到实体类，无需手动调用TryGetValue处理AttributeValue。
• 实体类特性必须和表的主键结构完全匹配（哈希键+范围键），否则会出现映射错误。
• QueryAsync支持分页，GetRemainingAsync()会获取所有匹配结果，若需分页可直接遍历返回的IAsyncEnumerable。

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