# Файл Catalog JSON

**Текущая схема**: [`v1`](https://schemas.getdbt.com/dbt/catalog/v1.json)

**Создаётся с помощью:** (Версии dbt: v2.0 и новее) флага [`--write-catalog`](https://docs.getdbt.tech/reference/commands/cmd-docs.md#--write-catalog-flag)

Этот файл содержит информацию из вашего data warehouse о таблицах и представлениях, создаваемых и определяемых ресурсами вашего проекта. (Версии dbt: v2.0 и новее) [dbt Docs v2](https://docs.getdbt.tech/reference/commands/cmd-docs.md#dbt-docs-v2) считывает данные из [dbt Information Schema](https://docs.getdbt.tech/docs/build/dbt-information-schema.md), а не из этого файла. `catalog.json` остаётся доступным в качестве отдельного артефакта для [Catalog](https://docs.getdbt.tech/docs/explore/explore-projects.md) и внешних инструментов.

### Ключи верхнего уровня

* [`metadata`](https://docs.getdbt.tech/reference/artifacts/dbt-artifacts.md#common-metadata)
* `nodes`: Словарь, содержащий информацию об объектах базы данных, соответствующих моделям, seed-файлам и снимкам dbt.
* `sources`: Словарь, содержащий информацию об объектах базы данных, соответствующих источникам dbt.
* `errors`: Ошибки, полученные при выполнении запросов к метаданным во время (Версии dbt: v2.0 и новее) генерации каталога (с помощью флага `--write-catalog`).

### Детали ресурсов

Внутри `sources` и `nodes` каждый ключ словаря является `unique_id` ресурса. Каждый вложенный ресурс содержит:

* `unique_id`: `<resource_type>.<package>.<resource_name>`, то же самое, что и ключ словаря, соответствует `nodes` и `sources` в [манифесте](https://docs.getdbt.tech/reference/artifacts/manifest-json.md)

* `metadata`

  * `type`: таблица, представление и т.д.
  * `database`
  * `schema`
  * `name`
  * `comment`
  * `owner`

* `columns` (массив)

  * `name`
  * `type`: тип данных
  * `comment`
  * `index`: порядковый номер

* `stats`: различается в зависимости от базы данных и типа отношения
