# full\_refresh

Конфигурация `full_refresh` позволяет задать, будет ли для ресурса полное обновление выполняться всегда или не будет выполняться никогда. Эта конфигурация имеет приоритет над флагом командной строки `--full-refresh`.

### Models

dbt\_project.yml

```yml
models:
  <resource-path>:
    +full_refresh: false | true 
```

models/\<modelname>.sql

```sql

{{ config(
    full_refresh = false | true
) }}

select ...
```

### Seeds

dbt\_project.yml

```yml
seeds:
  <resource-path>:
    +full_refresh: false | true
```

## Описание

Конфигурация `full_refresh` позволяет опционально задать, будет ли ресурс **всегда** или **никогда** выполнять полный пересчёт (full refresh). Эта конфигурация является переопределением флага командной строки `--full-refresh`, который используется при запуске команд dbt.

Вы можете задать конфигурацию `full_refresh` в файле `dbt_project.yml` или в конфигурации конкретного ресурса.

| Значение `full_refresh`                  | Поведение                                                                                                                           |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Если установлено в `true`                | Ресурс **всегда** выполняет полный пересчёт, независимо от того, передаёте ли вы флаг `--full-refresh` в команде dbt.               |
| Если установлено в `false`               | Ресурс **никогда** не выполняет полный пересчёт, независимо от того, передаёте ли вы флаг `--full-refresh` в команде dbt.           |
| Если установлено в `none` или не указано | Ресурс следует поведению флага `--full-refresh`. Если флаг используется, ресурс выполнит полный пересчёт; в противном случае — нет. |

Снапшоты игнорируют полное обновление

Снапшоты игнорируют как параметр конфигурации `full_refresh`, так и флаг `--full-refresh`. Команда, например `dbt build --full-refresh` или `dbt snapshot --full-refresh`, включающая узел снапшота, выполняет его в обычном режиме — таблица снапшота не удаляется и не создаётся заново, поэтому существующая история снапшота сохраняется.

#### Примечание

* Флаг `--full-refresh` также поддерживает сокращённую форму `-f`.
* В макросе [`should_full_refresh()`](https://github.com/dbt-labs/dbt-adapters/blob/60005a0a2bd33b61cb65a591bc1604b1b3fd25d5/dbt/include/global_project/macros/materializations/configs.sql) реализована соответствующая логика.

## Использование

### Инкрементные модели

* [Как перестроить инкрементную модель?](https://docs.getdbt.tech/docs/build/incremental-models.md#how-do-i-rebuild-an-incremental-model)
* [Что делать, если изменяются столбцы моей инкрементной модели?](https://docs.getdbt.tech/docs/build/incremental-models.md#what-if-the-columns-of-my-incremental-model-change)

### Seeds

Колонки моего seed изменились, и теперь я получаю ошибку при выполнении команды \`seed\`, что мне делать?

Если вы изменили колонки вашего seed, вы можете получить `Database Error`:

### Snowflake

```shell
$ dbt seed
Running with dbt=1.6.0-rc2
Found 0 models, 0 tests, 0 snapshots, 0 analyses, 130 macros, 0 operations, 1 seed file, 0 sources

12:12:27 | Concurrency: 8 threads (target='dev_snowflake')
12:12:27 |
12:12:27 | 1 of 1 START seed file dbt_claire.country_codes...................... [RUN]
12:12:30 | 1 of 1 ERROR loading seed file dbt_claire.country_codes.............. [ERROR in 2.78s]
12:12:31 |
12:12:31 | Finished running 1 seed in 10.05s.

Completed with 1 error and 0 warnings:

Database Error in seed country_codes (seeds/country_codes.csv)
  000904 (42000): SQL compilation error: error line 1 at position 62
  invalid identifier 'COUNTRY_NAME'

Done. PASS=0 WARN=0 ERROR=1 SKIP=0 TOTAL=1
```

### Redshift

```shell
$ dbt seed
Running with dbt=1.6.0-rc2
Found 0 models, 0 tests, 0 snapshots, 0 analyses, 149 macros, 0 operations, 1 seed file, 0 sources

12:14:46 | Concurrency: 1 threads (target='dev_redshift')
12:14:46 |
12:14:46 | 1 of 1 START seed file dbt_claire.country_codes...................... [RUN]
12:14:46 | 1 of 1 ERROR loading seed file dbt_claire.country_codes.............. [ERROR in 0.23s]
12:14:46 |
12:14:46 | Finished running 1 seed in 1.75s.

Completed with 1 error and 0 warnings:

Database Error in seed country_codes (seeds/country_codes.csv)
  column "country_name" of relation "country_codes" does not exist

Done. PASS=0 WARN=0 ERROR=1 SKIP=0 TOTAL=1
```

В этом случае вам следует повторно выполнить команду с флагом `--full-refresh`, как показано ниже:

```text
dbt seed --full-refresh
```

**Почему это необходимо?**

Когда вы обычно выполняете dbt seed, dbt очищает существующую таблица и вставляет данные заново. Этот подход позволяет избежать команды `drop cascade`, которая может привести к удалению зависимых объектов (которые могут использоваться вашими BI-пользователями!).

Однако, когда изменяются имена колонок или добавляются новые колонки, эти команды не выполнятся, так как структура таблицы изменилась.

Флаг `--full-refresh` заставит dbt выполнить `drop cascade` существующей таблицы перед её восстановлением.

## Рекомендация

* Устанавливайте `full_refresh: false` для моделей с особенно большими наборами данных, которые вы *никогда* не хотели бы, чтобы dbt полностью удалял и пересоздавал.

* Вы не можете переопределить уже заданный параметр `full_refresh`. Чтобы изменить его поведение в определённых случаях, необходимо удалить логику конфигурации или обновить её с использованием переменных, чтобы при необходимости поведение можно было переопределять. Например, если у вас есть инкрементальная модель со следующей конфигурацией:

  ```sql
  {{ config(
      materialized = 'incremental',
      full_refresh = var("force_full_refresh", false)
  ) }}
  ```

  Тогда вы можете переопределить параметр `full_refresh`, установив его в `true`, с помощью флага [`--vars`](https://docs.getdbt.tech/docs/build/project-variables.md#defining-variables-on-the-command-line):<br />`dbt run --vars '{"force_full_refresh": true}'`.

## Справочная документация

* [on\_configuration\_change](https://docs.getdbt.tech/reference/resource-configs/on_configuration_change.md)
