# volatility

Полезно знать

Доступно начиная с dbt v1.11 или в [канале релизов v1 Latest](https://docs.getdbt.tech/docs/dbt-versions/dbt-release-tracks.md).

functions/\<filename>.yml

```yml
functions:
  - name: <function name>
    config:
      volatility: deterministic | stable | non-deterministic
```

## Определение

Для UDF на SQL, Python или JavaScript можно дополнительно использовать [параметр `volatility`](https://docs.getdbt.tech/reference/resource-configs/volatility.md), чтобы указать, насколько предсказуем результат функции, с помощью значений `deterministic`, `stable` или `non-deterministic`. Хранилища данных используют эту информацию, чтобы определить, можно ли кэшировать результаты, изменять порядок вычислений или встраивать вызовы функции. Правильная настройка `volatility` помогает избежать некорректных результатов, когда кэширование результатов функции или изменение порядка её вычислений небезопасно.

Например:

* Функция, которая возвращает случайное число (`random()`), должна быть настроена как `non-deterministic`, поскольку её результат меняется при каждом вызове.
* Функция, которая возвращает текущую дату (`current_date()`), является `stable`: её значение остаётся неизменным в рамках одного выполнения запроса, но может изменяться между запросами. Если бы она была настроена как `deterministic`, хранилище данных могло бы ошибочно закэшировать значение и повторно использовать его в последующие дни.

По умолчанию dbt не указывает значение volatility. Если вы не задаёте volatility, dbt генерирует оператор `CREATE` без ключевого слова volatility, и применяется поведение хранилища данных по умолчанию — за исключением Redshift.

В Redshift dbt по умолчанию устанавливает `non-deterministic` (`VOLATILE`), если volatility не указана, потому что Redshift требует явного указания volatility, а `VOLATILE` является самым безопасным предположением.

 Ключевые слова для указания волатильности, зависящие от хранилища данных

Разные хранилища данных поддерживают управление волатильностью с помощью разных ключевых слов и значений по умолчанию:

| Warehouse                                                                                                                         | `deterministic`                | `stable`          | `non-deterministic`                                 |
| --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | ----------------- | --------------------------------------------------- |
| [Snowflake](https://docs.snowflake.com/en/sql-reference/sql/create-function#sql-handler)                                          | `IMMUTABLE`                    | Не поддерживается | `VOLATILE` (по умолчанию)                           |
| [Redshift](https://docs.aws.amazon.com/redshift/latest/dg/r_CREATE_FUNCTION.html#r_CREATE_FUNCTION-synopsis)                      | `IMMUTABLE`                    | `STABLE`          | `VOLATILE` (по умолчанию)                           |
| [Databricks](https://docs.databricks.com/aws/en/udf/unity-catalog#set-deterministic-if-your-function-produces-consistent-results) | `DETERMINISTIC`                | Не поддерживается | Считается `non-deterministic`, если не указано иное |
| [Postgres](https://www.postgresql.org/docs/current/xfunc-volatility.html)                                                         | `IMMUTABLE`                    | `STABLE`          | `VOLATILE` (по умолчанию)                           |
| [Starburst/Trino](https://docs.starburst.io/starburst-galaxy/reference/sql/ref/udf/function.html#synopsis)                        | `DETERMINISTIC` (по умолчанию) | Не поддерживается | `NOT DETERMINISTIC`                                 |

Для UDF на SQL и Python BigQuery не поддерживает явное указание категории изменчивости (volatility) и определяет её на основе используемых функций и выражений. Для UDF на JavaScript BigQuery поддерживает только `deterministic` и `non-deterministic`; `stable` не поддерживается.

## Поддерживаемые типы volatility

В dbt для конфигурации `volatility` можно использовать следующие значения:

| Значение            | Описание                                                                                                                                                                                                                                                                                                 | Пример                                                                                                                                                                                                              |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `deterministic`     | Всегда возвращает один и тот же результат для одинаковых входных данных. Безопасно для агрессивных оптимизаций и кэширования.                                                                                                                                                                            | `substr()` — Возвращает одну и ту же подстроку при одинаковой строке и параметрах.                                                                                                                                  |
| `stable`            | Возвращает одно и то же значение в рамках одного выполнения запроса, но может изменяться между выполнениями. Поддерживается не всеми хранилищами. Подробнее см. [Warehouse-specific volatility keywords](https://docs.getdbt.tech/reference/resource-configs/volatility.md#supported-volatility-types). | `now()` — Возвращает текущее время на момент начала запроса; остаётся постоянным в рамках одного запроса, но отличается между запусками.                                                                            |
| `non-deterministic` | Может возвращать разные результаты для одинаковых входных данных. Хранилища не должны кэшировать или переупорядочивать вычисления, предполагая стабильный результат.                                                                                                                                     | `first()` — Может возвращать разные строки в зависимости от плана запроса или порядка данных.<br />`random()` — Генерирует случайное число, которое меняется при каждом вызове, даже при одинаковых входных данных. |

## Пример

В этом примере используется volatility `deterministic` для функции `is_positive_int`:

functions/schema.yml

```yaml
functions:
  - name: is_positive_int
    description: Check whether a string is a positive integer
    config:
      volatility: deterministic # Optional: stable | non-deterministic | deterministic
    arguments:
      - name: a_string
        data_type: string
    returns:
      data_type: boolean
```

## Связанная документация

* [Пользовательские функции](https://docs.getdbt.tech/docs/build/udfs.md)
* [Свойства функций](https://docs.getdbt.tech/reference/function-properties.md)
* [Конфигурации функций](https://docs.getdbt.tech/reference/function-configs.md)
* [type](https://docs.getdbt.tech/reference/resource-configs/type.md)
* [arguments](https://docs.getdbt.tech/reference/resource-properties/function-arguments.md)
* [returns](https://docs.getdbt.tech/reference/resource-properties/returns.md)
