Set up docs MCPЭти настройки доступны в system.settings и автоматически сгенерированы из исходного кода.
vector_search_filter_strategy
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.5 | auto | новая настройка |
Если запрос векторного поиска содержит предложение WHERE, эта настройка определяет, что выполняется первым: оно (префильтрация) или проверка индекса векторного сходства (постфильтрация). Возможные значения:
- 'auto' - Постфильтрация (точная семантика может измениться в будущем).
- 'postfilter' - Использовать индекс векторного сходства для поиска ближайших соседей, затем применить другие фильтры
- 'prefilter' - Сначала применить другие фильтры, затем выполнить поиск полным перебором для определения соседей.
vector_search_index_fetch_multiplier
Псевдонимы: vector_search_postfilter_multiplier
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.8 | 1 | Псевдоним настройки 'vector_search_postfilter_multiplier' |
Умножает количество ближайших соседей, получаемых из индекса векторного сходства, на это число. Применяется только при постфильтрации с другими предикатами или если установлена настройка vector_search_with_rescoring = 1. Допустимый диапазон: [1.0, 1000.0]. Значения вне этого диапазона отклоняются.
vector_search_use_quantized_codes
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 26.7 | 0 | Новая настройка для включения двухэтапной оптимизации приблизительного векторного поиска по столбцу с кодеком Quantize(...); по умолчанию запросы остаются точными. |
Включает двухэтапный приблизительный векторный поиск без индекса (полный перебор) по столбцу, сжатому с помощью Quantized. Если настройка включена, то ORDER BY L2Distance|cosineDistance(vec, reference) LIMIT k для столбца, закодированного кодеком Quantized(...), будет:
- выполнять сканирование и фильтрацию квантизованных векторов (на этом этапе получается
k * vector_search_index_fetch_multiplierрезультатов), и - повторно оценивать найденные векторы по исходным полноточным векторам.
vector_search_with_rescoring
История версий
| Версия | Значение по умолчанию | Комментарий |
|---|---|---|
| 25.8 | 0 | Новая настройка |
Выполняет ли ClickHouse пересчёт оценок для запросов, использующих индекс векторного сходства.
Без пересчёта оценок индекс векторного сходства сразу возвращает строки с наилучшими совпадениями.
С пересчётом оценок индекс векторного сходства загружает строки-кандидаты, а ClickHouse вычисляет точное расстояние
для этих строк по исходным векторам полной точности в обычном SQL-конвейере.
Когда это возможно, ClickHouse ограничивает сканирование строками-кандидатами до окончательного вычисления расстояния.
Увеличьте vector_search_index_fetch_multiplier, если для повышения полноты требуется больше строк-кандидатов, особенно
при наличии дополнительных фильтров или квантованных векторных индексов.
Примечание: запрос, выполняемый без пересчёта оценок и с включёнными параллельными репликами, может переключиться на пересчёт оценок.