enable_new_ann

是否使用新的 ANN 执行路径。

在 users.xml 中设置。

0

设置为 1 开启。

hnsw_ef_s

基于 HNSW index 进行 search 时，使用的搜索参数，值越大，准确度越高。

在 users.xml 中设置。

10

Recall 90 以上场景，一般需要设置到 128 以上。

nprobe

使用 Faiss IVF 索引（IVF_FLAT、IVF_PQ、IVF_PQ_FS 索引）的搜索参数，表示搜索使用的聚类中心数量。理论上，nprobe 越大，准确度越大，延迟越高。

在 users.xml 中设置。

0 （默认为 0 表示未进行设置，index 中默认使用参数为 1）

Recall 90 以上场景，考虑设置到 nlist 的 1/4 以上。

k_factor_rf

使用 Faiss 包含 refine 的索引（IVF_PQ_FS 索引）时的搜索参数，k_factor_rf 越大，用于排序的结果越多，准确度越高，延迟越高。

在 users.xml 中设置。

0 （同上）

使用了 refine 的索引，在 recall 较低情况，可以尝试调大，可以先尝试设置为 100，视情况进行微调。

vector_index_build_threads

每个 part build threads 数量。

在 users.xml 中设置。

8

单个 part 的 build threads 控制，如果并发导入或者合并并发度较高，建议调小。

enable_global_vector_index_preload

是否在 server start up 或者 part 创建以后，直接将 index load 到 cache 中。

在 users.xml 中设置。

0

写入加速。写入后的 part 的向量索引直接进入缓存，消除索引加载时间。

log_processors_profiles

禁用处理器配置文件日志，减少日志写入开销，提升查询性能。

在 users.xml 中设置。

0（禁用）

建议设置为 0。

compile_expressions

关闭表达式编译优化，避免复杂向量计算的编译耗时。

在 users.xml 中设置。

0（禁用）

建议设置为 0。

compile_sort_description

关闭排序描述编译优化，提升向量排序操作的性能。

在 users.xml 中设置。

0（禁用）

建议设置为 0。

vector_index_cache_size

向量索引可使用的 memory cache 大小。采用 LRU 策略淘汰。

在 config.xml 中设置。

max_server_memory_usage * 0.5

需要预留一部分缓存给构建索引使用，考虑到会有后台的合并或者变更任务，建议为索引缓存预留小于等于一半最大内存量，如果合并并发度较高，考虑进一步缩小索引缓存大小。

enable_use_local_lock

启用本地锁机制，减少写入冲突，提升高并发场景下的向量数据写入性能。

在 config.xml 中设置。

0（禁用）

建议设置为 1（启用）。

disk_unique_key_index_meta_cache_size

唯一键索引元数据的缓存大小，优化键值检索性能。

在 config.xml 中设置。

无

建议 2GB 以上。

disk_unique_key_index_data_cache_size

唯一键索引数据的缓存大小，提升数据读取速度。

在 config.xml 中设置。

无

建议 5GB 以上。

additional_services

动态启用额外服务，无需重启服务。

在 config.xml 中设置。

0（禁用）

可按需启用。