> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# настройки сеанса short_circuit_function_evaluation_*

> Настройки сеанса ClickHouse из сгенерированной группы short_circuit_function_evaluation_*.

Эти настройки доступны в [system.settings](https://clickhouse.com/docs/ru/reference/system-tables/settings.md) и автоматически генерируются на основе [исходного кода](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

## short\_circuit\_function\_evaluation

Тип

ShortCircuitFunctionEvaluation

По умолчанию

enable

Позволяет вычислять функции [if](https://clickhouse.com/docs/ru/reference/functions/regular-functions/conditional-functions.md#if), [multiIf](https://clickhouse.com/docs/ru/reference/functions/regular-functions/conditional-functions.md#multiIf), [and](https://clickhouse.com/docs/ru/reference/functions/regular-functions/logical-functions.md#and) и [or](https://clickhouse.com/docs/ru/reference/functions/regular-functions/logical-functions.md#or) по принципу [короткого замыкания](https://en.wikipedia.org/wiki/Short-circuit_evaluation). Это помогает оптимизировать вычисление сложных выражений в этих функциях и предотвращать возможные исключения (например, деление на ноль там, где оно не должно выполняться).

Возможные значения:

* `enable` — Включает вычисление функций с коротким замыканием для функций, где это применимо (то есть для тех, которые могут сгенерировать исключение или требуют больших вычислительных затрат).
* `force_enable` — Включает вычисление функций с коротким замыканием для всех функций.
* `disable` — Отключает вычисление функций с коротким замыканием.

## short\_circuit\_function\_evaluation\_for\_nulls

Тип

Bool

По умолчанию

1

Оптимизирует вычисление функций, которые возвращают NULL, если хотя бы один аргумент равен NULL. Когда доля NULL-значений в аргументах функции превышает short\_circuit\_function\_evaluation\_for\_nulls\_threshold, система пропускает построчное вычисление функции. Вместо этого она сразу возвращает NULL для всех строк, избегая лишних вычислений.

Эта настройка управляет только оптимизацией. Функции, которые не могут быть выполнены со значениями по умолчанию своих аргументов — такие как `parseDateTime`, `IPv4StringToNum` или `intDiv` — всегда пропускают строки, содержащие NULL, независимо от этой настройки: за NULL хранится значение по умолчанию для типа аргумента, и выполнение над ним сгенерировало бы исключение на в остальном корректных данных.

## short\_circuit\_function\_evaluation\_for\_nulls\_threshold

Тип

Double

По умолчанию

1

Пороговое отношение NULL-значений, при котором функции с аргументами Nullable выполняются только для строк, где во всех аргументах значения отличны от NULL. Применяется, когда включена настройка short\_circuit\_function\_evaluation\_for\_nulls.
Когда отношение строк, содержащих NULL-значения, к общему числу строк превышает этот порог, строки с NULL-значениями не вычисляются.

## short\_circuit\_function\_evaluation\_reorder\_arguments

Тип

Bool

По умолчанию

1

Позволяет изменять порядок вычисления аргументов функций [and](https://clickhouse.com/docs/ru/reference/functions/regular-functions/logical-functions.md#and) и [or](https://clickhouse.com/docs/ru/reference/functions/regular-functions/logical-functions.md#or) при [укороченном вычислении](https://clickhouse.com/docs/ru/reference/settings/session-settings/short-circuit-function-evaluation.md#short_circuit_function_evaluation), если это не влияет на результат и не приводит к исключениям.

* Если первый аргумент требует больших вычислительных затрат, а другой вычисляется дёшево, то сначала вычисляется дешёвый аргумент, а тяжёлый — только для тех строк, для которых результат ещё не определён. Например, в `WHERE JSONExtractString(json, 'a') = 'x' AND id < 100` JSON разбирается только для строк с `id < 100`.
* Аргументы, которые вычисляются лениво и не могут сгенерировать исключение, вычисляются в порядке возрастания времени, затрачиваемого на каждую строку, для которой они определяют результат; это время измеряется на предыдущих блоках. Аргументы, которые могут сгенерировать исключение, всегда остаются после всех предшествующих им аргументов, поэтому, например, в выражении `x != 0 AND intDiv(1, x) > 0` деления на ноль никогда не происходит.
