如何在仅知DynamoDB部分排序键前缀时高效查询数据

当已知dynamodb分区键但仅掌握排序键的前缀（而非完整值）时，应使用queryconditional.sortbeginswith()构建查询条件，而非keyequalto()——后者要求提供完整的复合主键，否则将触发400 schema不匹配错误。

在DynamoDB中，query操作必须指定分区键（Partition Key），而排序键（Sort Key）可选择性地进行范围匹配。当你只知道排序键的起始部分（例如 "KEY_SORT#Alice" 中仅确定 "KEY_SORT#Ali"），应避免使用 keyEqualTo()（它隐含要求精确匹配完整主键），转而采用 sortBeginsWith() —— 这是增强型DynamoDB SDK（v2）专为前缀匹配设计的安全、高效方式。

以下是一个符合你数据模型的正确示例（注意：partitionValue 必须与表中实际存储的PK值完全一致；sortValue 仅传入已知前缀）：

String partitionPrefix = "KEY#" + id; // 如 "KEY#123"
String sortKeyPrefix = "KEY_SORT#" + namePrefix; // 如 "KEY_SORT#Ali"（非完整getName()）

QueryConditional condition = QueryConditional.sortBeginsWith(
    Key.builder()
        .partitionValue(partitionPrefix)  // ✅ 必须与写入时 getPk() 生成的值完全一致
        .sortValue(sortKeyPrefix)         // ✅ 仅传入已知前缀，无需补全
        .build()
);

QueryEnhancedRequest request = QueryEnhancedRequest.builder()
    .queryConditional(condition)
    .build();

// 执行查询（假设 table 是 DynamoDbTable 实例）
table.query(request).stream()
    .map(Page::items)
    .flatMap(List::stream)
    .forEach(System.out::println);

⚠️ 关键注意事项：

• sortBeginsWith() 必须配合 query() 使用，且表必须已正确定义复合主键（PK + SK）；
• partitionValue 字符串必须与写入时 getPk() 返回值逐字节一致（包括大小写、分隔符、编码）；
• 排序键前缀需严格遵循你定义的格式（如 "KEY_SORT#" + 名称），不可截断至非边界位置（例如 "KEY_SOR" 会匹配失败或产生意外结果）；
• 此方法利用DynamoDB底层的字典序索引，性能高效，无全表扫描开销；
• 若需进一步过滤（如按属性值筛选），可在 QueryEnhancedRequest.builder() 中链式调用 .filterExpression(...)，但注意过滤发生在查询后，不减少RCU消耗。

总结：面对“知PK、知SK前缀、不知SK全量”的典型场景，sortBeginsWith() 是语义清晰、性能可靠、SDK原生支持的标准解法——它既规避

了 keyEqualTo() 的完整性约束，又比 scan() 操作具备数量级的性能与成本优势。