# Об артефактах dbt

(Версии dbt: v1.12 и новее)

При каждом вызове dbt создает и сохраняет один или несколько *артефактов*. Некоторые из них — файлы JSON (`semantic_manifest.json`, `osi_document.json`, `manifest.json`, `catalog.json`, `run_results.json` и `sources.json`), которые используются для следующих возможностей:

* [документация](https://docs.getdbt.tech/docs/explore/build-and-view-your-docs.md)
* [состояние](https://docs.getdbt.tech/reference/node-selection/syntax.md#how-does-selection-work)
* [визуализация актуальности данных источников](https://docs.getdbt.tech/docs/build/sources.md#source-data-freshness)

Они также могут быть использованы для:

* получать инсайты о вашем [Semantic Layer](https://docs.getdbt.tech/docs/use-dbt-semantic-layer/dbt-sl.md)
* рассчитывать покрытие тестами на уровне проекта
* выполнять продольный анализ времени выполнения запусков
* выявлять исторические изменения в структуре таблица
* и делать многое, многое другое

### Когда создаются артефакты? [Starter](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе")[Enterprise](https://www.getdbt.com/pricing "Подробнее о статусе или тарифе")

Большинство команд dbt (и соответствующих методов RPC) создают артефакты:

* [семантический манифест](https://docs.getdbt.tech/reference/artifacts/sl-manifest.md): создаётся при каждом разборе вашего проекта dbt

(Версии dbt: v1.12 и новее)

* [документ Apache Ossie](https://docs.getdbt.tech/reference/artifacts/sl-manifest.md#apache-ossie-document): создаётся при каждом разборе вашего проекта dbt

- [манифест](https://docs.getdbt.tech/reference/artifacts/manifest-json.md): создаётся командами, которые читают и анализируют ваш проект
- [результаты выполнения](https://docs.getdbt.tech/reference/artifacts/run-results-json.md): создаются командами, которые выполняют, компилируют или каталогизируют узлы вашего DAG
- [каталог](https://docs.getdbt.tech/reference/artifacts/catalog-json.md): создаётся командой `docs generate`

(Версии dbt: v2.0 и новее)

* [источники](https://docs.getdbt.tech/reference/artifacts/sources-json.md): создаётся командой `dbt freshness`, если включены источники; сохраняется для обратной совместимости
* [актуальность данных](https://docs.getdbt.tech/reference/artifacts/freshness-json.md): создаётся командой [`dbt freshness`](https://docs.getdbt.tech/reference/commands/freshness.md); охватывает как источники, так и модели с настроенной проверкой актуальности данных; поле `resource_type` в каждой записи позволяет различать их

При выполнении команд из [dbt CLI](https://docs.getdbt.tech/docs/platform/dbt-cli-installation.md) все артефакты скачиваются по умолчанию. Если вы хотите изменить это поведение, см. раздел [Как отключить скачивание артефактов](https://docs.getdbt.tech/docs/platform/configure-dbt-cli.md#considerations-1).

## Где создаются артефакты?

По умолчанию артефакты записываются в директорию `/target` вашего dbt проекта. Вы можете настроить расположение с помощью флага [`target-path`](https://docs.getdbt.tech/reference/global-configs/json-artifacts.md).

## Общие метаданные

Все артефакты, создаваемые dbt, включают словарь `metadata` с такими свойствами:

* `dbt_version`: Версия dbt, которая создала этот артефакт. Для получения подробной информации о версионировании релизов обратитесь к [Версионирование](https://docs.getdbt.tech/reference/commands/version.md#versioning).
* `dbt_schema_version`: URL схемы этого артефакта. См. примечания ниже.
* `generated_at`: Временная метка в UTC, когда этот артефакт был создан.
* `adapter_type`: Адаптер (база данных), например, `postgres`, `spark` и т.д.
* `env`: Любые переменные окружения с префиксом `DBT_ENV_CUSTOM_ENV_` будут включены в словарь, где имя переменной без префикса будет ключом.
* [`invocation_id`](https://docs.getdbt.tech/reference/dbt-jinja-functions/invocation_id.md): Уникальный идентификатор для этого вызова dbt

В манифесте `metadata` также может содержать:

* `send_anonymous_usage_stats`: Отправлялась ли [анонимная статистика использования](https://docs.getdbt.tech/reference/global-configs/usage-stats.md) во время выполнения этого вызова.
* `project_name`: Значение `name`, определённое в файле `dbt_project.yml` корневого проекта. (Добавлено в манифесте v10 / dbt v1.6)
* `project_id`: Идентификатор проекта, полученный хешированием `project_name`; отправляется вместе с анонимной статистикой использования, если её отправка включена.
* `user_id`: Идентификатор пользователя, по умолчанию хранящийся в `~/dbt/.user.yml`; отправляется вместе с анонимной статистикой использования, если её отправка включена.

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

* Структура dbt артефактов канонизирована с помощью [JSON схем](https://json-schema.org/), которые размещены на [schemas.getdbt.com](https://schemas.getdbt.com/).
* Версии артефактов могут изменяться в любой минорной версии dbt (`v1.x.0`). Каждый артефакт версионируется независимо.

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

* [Другие артефакты](https://docs.getdbt.tech/reference/artifacts/other-artifacts.md) файлы, такие как `index.html` или `graph_summary.json`.
