# on\_configuration\_change

к сведению

Эта функциональность в настоящее время поддерживается только для [материализованных представлений](https://docs.getdbt.tech/docs/build/materializations.md#materialized-view) на ограниченном наборе адаптеров.

Конфигурация `on_configuration_change` имеет три настройки:

* `apply` (по умолчанию) — Пытается обновить существующий объект базы данных, если это возможно, избегая полного пересоздания.
  * *Примечание:* Если любое отдельное изменение конфигурации требует полного обновления, выполняется полное обновление вместо отдельных операторов изменения.
* `continue` — Позволяет продолжить выполнение, при этом выдавая предупреждение о том, что объект остался нетронутым.
  * *Примечание:* Это может привести к сбоям в последующих моделях, так как они могут зависеть от этих не реализованных изменений.
* `fail` — Принудительно завершает выполнение, если обнаружено изменение.

### YAML-файл проекта

dbt\_project.yml

```yaml
models:
  <resource-path>:
    +materialized: <materialization_name>
    +on_configuration_change: apply | continue | fail
```

### YAML-файл свойств

models/properties.yml

```yaml

models:
  - name: [<model-name>]
    config:
      materialized: <materialization_name>
      on_configuration_change: apply | continue | fail
```

### Конфигурация в SQL-файле

models/\<model\_name>.sql

```jinja
{{ config(
    materialized="<materialization_name>",
    on_configuration_change="apply" | "continue" | "fail"
) }}
```

## Приоритет создания

Материализации реализуются в соответствии со следующим жизненным циклом с последовательной проверкой условий:

1. Если модель не существует по указанному пути, создать новую модель.
2. Если модель существует, но имеет другой тип, удалить существующую модель и создать новую.
3. Если указан [`--full-refresh`](https://docs.getdbt.tech/reference/resource-configs/full_refresh.md), заменить существующую модель независимо от изменений конфигурации и значения настройки [`on_configuration_change`](https://docs.getdbt.tech/reference/resource-configs/on_configuration_change.md).
   * Пользователям BigQuery после изменения материализации модели (например, с `table` на `view`) может потребоваться выполнить `dbt run --full-refresh` (вместо `dbt run`), чтобы dbt полностью заменил существующий объект базы данных и изменение было применено в полном объёме.
4. Если изменений конфигурации нет, выполнить действие по умолчанию для данного типа (например, обновить материализованное представление).
5. Определить, следует ли применять изменения конфигурации, в соответствии со значением настройки `on_configuration_change`.
