ES 9.1 及以上版本新增支持把向量重打分配置 rescore_vector 写进 dense_vector 字段的 mapping 里,不用每次在 knn 查询请求里重复携带这个配置,适合量化向量索引(BBQ、int4/int8 量化),用来控制粗排之后的过采样精排逻辑,但是这个 oversample 参数有严格的数值范围校验,只要填错范围、格式不对,创建索引或者更新 mapping 的时候就会直接 400 报错,不会静默忽略,同时查询端携带的 rescore_vector 优先级会覆盖 mapping 里的默认配置,适合大部分业务固定一套重打分策略、少量查询单独调整的场景。
参数基础信息表
| 项目 | 详情 |
|---|---|
| 版本门槛 | Elasticsearch 9.1+ |
| 所属字段 | dense_vector,index_options 为量化类型(BBQ、int4、int8) |
| 配置节点 | mapping -> properties -> 向量字段 -> rescore_vector |
| 唯一子参数 | oversample(浮点) |
| 合法取值 | 0,或者大于 1、小于等于 10 |
| 取值含义 | 0 = 关闭重打分;1~10 = 过采样倍数,粗排取 k*oversample 候选做原始向量精排 |
| 优先级 | 查询 knn 内 rescore_vector > mapping 内 rescore_vector |
| 限制 | 非量化 hnsw 原始向量索引不支持 rescore_vector 配置 |
mapping 正确示例
PUT vector-test-index
{
"mappings": {
"properties": {
"embedding": {
"type": "dense_vector",
"dims": 768,
"index_options": {
"type": "bbq"
},
"rescore_vector": {
"oversample": 3.0
}
}
}
}
}
常见填错触发报错场景
- 填负数(-1、-0.5):直接校验失败,返回构建 rescore_vector 失败
- 填大于 10 的数值(11、12):超出上限,参数非法报错
- 填 0~1 之间小数(0.5、0.8):不属于合法区间,直接报错
- 放到非量化 hnsw 索引上:该索引类型不支持 rescore_vector,mapping 报错
- 拼写错误 rescore_oversample、rescore:识别为未知字段
向量重打分的完整工作流程
- 写入 mapping,给量化向量字段预设 rescore_vector.oversample;
- 执行 knn 向量检索,ES 先用压缩量化向量做 HNSW 粗排;
- 按照 oversample 倍数,取出 k*oversample 条候选文档;
- 读取原始高精度向量,重新计算相似度分数完成精排;
- 如果当前 knn 查询里单独写了 rescore_vector,优先使用查询里的值,覆盖 mapping 默认值;
- oversample 设为 0 时,跳过精排重打分,直接使用量化粗排结果返回。
参数选型建议
✅ 推荐取值
- BBQ 磁盘量化:一般 3~5 倍,召回提升明显,耗时可控
- int8 量化:1.5~2 倍即可,本身精度损失小
- 不需要精排、追求极致速度:设置 oversample=0
- 超过 10:ES 不允许,直接报错;同时会读取大量原始向量,延迟暴涨
- 0~1 之间小数:语法校验不通过,创建索引失败
❌ 不建议
两种配置方式对比
- 写在 mapping:全局默认,所有 knn 查询自动生效,减少查询语句冗余,适合策略统一的业务
- 写在 knn 查询里:单次查询临时覆盖,适合少量查询需要调高 / 关闭重打分的场景
【常见问题】
问题 1:ES 向量重打分 rescore_vector 写入 mapping,oversample 填什么值不会报错?
回答 1:ES 向量重打分 rescore_vector 写入 mapping,oversample 合法值只有 0,或者大于 1、小于等于 10 的浮点数,填负数、0 到 1 之间、大于 10 都会触发校验报错。
问题 2:ES 向量重打分 rescore_vector 写进 mapping 之后,查询还能单独覆盖吗?
回答 2:ES 向量重打分 rescore_vector 写进 mapping 之后,knn 查询内部配置的 rescore_vector 优先级更高,会直接覆盖 mapping 里面预设的 oversample。
问题 3:ES 向量重打分 rescore_vector 配置在 mapping,普通 hnsw 非量化向量可以用吗?
回答 3:ES 向量重打分 rescore_vector 配置在 mapping,只支持 BBQ、int4、int8 这类量化索引,普通 hnsw 原始向量索引不支持这个参数,配置会报错。
问题 4:ES 向量重打分 rescore_vector 的 oversample 设为 0 是什么效果?
回答 4:ES 向量重打分 rescore_vector 的 oversample 设为 0,代表关闭向量重打分精排,只使用量化粗排分数返回结果,节省读取原始向量的开销。
【参考资料】
[2026-11-12](向量|ES 的重打分能写进 mapping,rescore_vector 填错会报错)腾讯云开发者社区
[2026-11-12](Elasticsearch 9.1 dense_vector rescore_vector 官方文档)Elastic 官方文档
[2026-11-04](ES rescore_oversample 参数边界测试,0 合法负数报错)腾讯云开发者社区
[2026-10-20](ES BBQ 量化向量索引重打分机制说明)Elastic Labs
[2026-09-15](ES9.1 向量检索新特性 rescore_vector 介绍)掘金
【免责声明】
本文仅为 ES 向量 rescore_vector 配置技术科普,rescore_vector 特性仅在 ES9.1 及以上版本生效;不同云厂商 ES 托管版可能存在版本差异、参数限制,创建索引、上线前务必在测试环境验证 mapping 和查询语句,本文不构成生产环境直接上线方案。
