# materialized

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

dbt\_project.yml

```yaml
config-version: 2

models:
  <resource-path>:
    +materialized: <materialization_name>
```

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

models/properties.yml

```yaml

models:
  - name: <model_name>
    config:
      materialized: <materialization_name>
```

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

models/\<model\_name>.sql

```jinja
{{ config(
  materialized="<materialization_name>"
) }}

select ...
```

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

[Материализации](https://docs.getdbt.tech/docs/build/materializations.md#materializations) — это стратегии для сохранения моделей dbt в хранилище данных. Вот типы материализаций, встроенные в dbt:

* `ephemeral` — [эфемерные](https://docs.getdbt.tech/docs/build/materializations.md#ephemeral) модели не создаются непосредственно в базе данных
* `table` — модель пересоздаётся как [таблица](https://docs.getdbt.tech/docs/build/materializations.md#table) при каждом запуске
* `view` — модель пересоздаётся как [представление](https://docs.getdbt.tech/docs/build/materializations.md#view) при каждом запуске
* `materialized_view` — позволяет создавать и поддерживать [материализованные представления](https://docs.getdbt.tech/docs/build/materializations.md#materialized-view) в целевой базе данных
* `incremental` — [инкрементальные](https://docs.getdbt.tech/docs/build/materializations.md#incremental) модели позволяют dbt вставлять или обновлять записи в `table`, изменившиеся с момента последнего запуска этой модели

Вы также можете настроить [пользовательские материализации](https://docs.getdbt.tech/guides/create-new-materializations.md?step=1) в dbt. Пользовательские материализации — это мощный способ расширить функциональность dbt в соответствии с вашими конкретными потребностями.

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

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

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`.
