# О проектах dbt

Проект dbt информирует dbt о контексте вашего проекта и о том, как трансформировать ваши данные (создавать наборы данных). По замыслу, dbt обеспечивает верхнеуровневую структуру проекта dbt, такую как файл `dbt_project.yml`, директорию `models`, директорию `snapshots` и так далее. В пределах верхнеуровневых директорий вы можете организовать свой проект любым способом, который соответствует потребностям вашей организации и конвейера данных.

Минимально, все, что нужно проекту, это файл конфигурации проекта `dbt_project.yml`. dbt поддерживает ряд различных ресурсов, поэтому проект может также включать:

| Ресурс                                                                          | Описание                                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [models](https://docs.getdbt.tech/docs/build/models.md)                        | Каждая модель хранится в одном файле и содержит логику, которая либо преобразует сырые данные в набор данных, готовый для аналитики, либо, что встречается чаще, является промежуточным шагом такого преобразования.                                             |
| [snapshots](https://docs.getdbt.tech/docs/build/snapshots.md)                  | Способ зафиксировать состояние изменяемых таблиц, чтобы к нему можно было обратиться позже.                                                                                                                                                                      |
| [seeds](https://docs.getdbt.tech/docs/build/seeds.md)                          | CSV-файлы со статическими данными, которые можно загрузить в вашу платформу данных с помощью dbt.                                                                                                                                                                |
| [data tests](https://docs.getdbt.tech/docs/build/data-tests.md)                | SQL-запросы, которые вы можете писать для тестирования моделей и ресурсов в вашем проекте.                                                                                                                                                                       |
| [macros](https://docs.getdbt.tech/docs/build/jinja-macros.md)                  | Блоки кода, которые можно переиспользовать многократно.                                                                                                                                                                                                          |
| [docs](https://docs.getdbt.tech/docs/build/documentation.md)                   | Документация для вашего проекта, которую вы можете сгенерировать.                                                                                                                                                                                                |
| [sources](https://docs.getdbt.tech/docs/build/sources.md)                      | Способ именовать и описывать данные, загружаемые в ваше хранилище инструментами Extract и Load.                                                                                                                                                                  |
| [exposures](https://docs.getdbt.tech/docs/build/exposures.md)                  | Способ определить и описать downstream-использование вашего проекта.                                                                                                                                                                                             |
| [metrics](https://docs.getdbt.tech/docs/build/build-metrics-intro.md)          | Способ определить метрики для вашего проекта.                                                                                                                                                                                                                    |
| [Группы](https://docs.getdbt.tech/docs/build/groups.md)                        | Объединяют узлы в отдельные группы.                                                                                                                                                                                                                              |
| [analysis](https://docs.getdbt.tech/docs/build/analyses.md)                    | Способ организовать аналитические SQL-запросы в вашем проекте, например главный бухгалтерский журнал (general ledger) из QuickBooks.                                                                                                                             |
| [Семантические модели](https://docs.getdbt.tech/docs/build/semantic-models.md) | Определяют базовые отношения данных в [MetricFlow](https://docs.getdbt.tech/docs/build/about-metricflow.md) и [Semantic Layer](https://docs.getdbt.tech/docs/use-dbt-semantic-layer/dbt-sl.md), чтобы метрики можно было запрашивать через семантический граф. |
| [Сохранённые запросы](https://docs.getdbt.tech/docs/build/saved-queries.md)    | Объединяют метрики, измерения и фильтры в переиспользуемые узлы графа dbt.                                                                                                                                                                                       |
| [user-defined functions](https://docs.getdbt.tech/docs/build/udfs.md)          | Пользовательские функции (UDFs) позволяют создавать переиспользуемые кастомные функции в вашем хранилище, которыми можно делиться между dbt, BI-инструментами, workflow для data science и другими системами.                                                    |

При создании структуры вашего проекта вы должны учитывать следующие аспекты, влияющие на рабочий процесс вашей организации:

* **Как пользователи будут запускать команды dbt** — Выбор пути
* **Как пользователи будут ориентироваться в проекте** — Будь то разработчики в Studio IDE или заинтересованные стороны, использующие документацию
* **Как пользователи будут настраивать модели** — Некоторые общие настройки проще задавать на уровне каталога, чтобы пользователям не приходилось помнить о необходимости указывать всё в блоке конфигурации для каждой новой модели

## Конфигурация проекта

Каждый проект dbt включает файл конфигурации проекта под названием `dbt_project.yml`. Он определяет директорию проекта dbt и другие конфигурации проекта.

Редактируйте `dbt_project.yml`, чтобы настроить общие конфигурации проекта, такие как:

| YAML ключ                                                                                         | Описание значения                                                                                            |
| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| [name](https://docs.getdbt.tech/reference/project-configs/name.md)                               | Название вашего проекта в формате [snake case](https://en.wikipedia.org/wiki/Snake_case)                     |
| [version](https://docs.getdbt.tech/reference/project-configs/version.md)                         | Версия вашего проекта                                                                                        |
| [require-dbt-version](https://docs.getdbt.tech/reference/project-configs/require-dbt-version.md) | Ограничение совместимости проекта диапазоном [версий dbt v1](https://docs.getdbt.tech/docs/dbt-versions.md) |
| [profile](https://docs.getdbt.tech/reference/project-configs/profile.md)                         | Профиль, который dbt использует для подключения к вашей платформе данных                                     |
| [model-paths](https://docs.getdbt.tech/reference/project-configs/model-paths.md)                 | Каталоги, в которых находятся файлы моделей и источников                                                     |
| [seed-paths](https://docs.getdbt.tech/reference/project-configs/seed-paths.md)                   | Каталоги, в которых находятся seed-файлы                                                                     |
| [test-paths](https://docs.getdbt.tech/reference/project-configs/test-paths.md)                   | Каталоги, в которых находятся файлы тестов                                                                   |
| [analysis-paths](https://docs.getdbt.tech/reference/project-configs/analysis-paths.md)           | Каталоги, в которых находятся ваши аналитические запросы                                                     |
| [macro-paths](https://docs.getdbt.tech/reference/project-configs/macro-paths.md)                 | Каталоги, в которых находятся ваши макросы                                                                   |
| [snapshot-paths](https://docs.getdbt.tech/reference/project-configs/snapshot-paths.md)           | Каталоги, в которых находятся ваши снимки                                                                    |
| [docs-paths](https://docs.getdbt.tech/reference/project-configs/docs-paths.md)                   | Каталоги, в которых находятся ваши блоки документации                                                        |
| [vars](https://docs.getdbt.tech/docs/build/project-variables.md)                                 | Переменные проекта, которые вы хотите использовать при компиляции данных                                     |

Для получения полной информации о конфигурациях проекта, смотрите [dbt\_project.yml](https://docs.getdbt.tech/reference/dbt_project.yml.md).

## Поддиректории проекта

Вы можете использовать параметр Project subdirectory в dbt, чтобы указать подкаталог в вашем git-репозитории, который dbt должен использовать в качестве корневого каталога проекта. Это полезно, если в одном репозитории находится несколько проектов dbt или если вы хотите распределить файлы проекта dbt по подкаталогам для удобства управления.

Чтобы использовать параметр Project subdirectory в dbt, выполните следующие действия:

1. Нажмите на имя вашей учетной записи в левом нижнем углу и выберите **Your profile**.

2. В разделе **Проекты** выберите проект, который вы хотите настроить как поддиректорию проекта.

3. Выберите **Редактировать** в нижнем правом углу страницы.

4. В поле **Project subdirectory** укажите имя подкаталога. Например, если YAML‑файлы вашего проекта находятся в подкаталоге `<repository>/finance`, необходимо указать `finance` в качестве подкаталога.

   * Вы также можете указывать вложенные подкаталоги. Например, если YAML‑файлы вашего проекта находятся в `<repository>/teams/finance`, в поле подкаталога следует указать `teams/finance`. **Примечание**: в поле Project subdirectory не требуется указывать начальный или конечный символ `/`.

5. Нажмите **Сохранить**, когда закончите.

После настройки параметра Project subdirectory dbt будет использовать указанный подкаталог в качестве корневого каталога вашего проекта dbt. Это означает, что команды dbt, такие как `dbt run` или `dbt test`, будут работать с файлами в указанном подкаталоге. Если в подкаталоге, указанном в Project subdirectory, нет файла `dbt_project.yml`, вам будет предложено инициализировать проект dbt.

Поддержка проектов в тарифных планах dbt

Некоторые [планы](https://www.getdbt.com/pricing) поддерживают только один dbt‑проект, тогда как [планы уровня Enterprise](https://www.getdbt.com/contact) позволяют работать с несколькими проектами и использовать [межпроектные ссылки](https://docs.getdbt.tech/best-practices/how-we-mesh/mesh-1-intro.md) с помощью Mesh.

## Новые проекты

Вы можете создавать новые проекты и [делиться ими](https://docs.getdbt.tech/docs/platform/git/git-version-control.md) с другими людьми, размещая их в репозитории Git на таких платформах, как GitHub, GitLab и BitBucket.

После настройки подключения к вашей платформе данных вы можете [инициализировать новый проект в dbt](https://docs.getdbt.tech/guides.md) и начать разработку. Или выполните [dbt init из командной строки](https://docs.getdbt.tech/reference/commands/init.md), чтобы настроить новый проект.

Во время инициализации проекта dbt создает примерные файлы моделей в вашей директории проекта, чтобы помочь вам быстро начать разработку.

## Примерные проекты

Если вы хотите подробнее изучить проекты dbt, обратитесь к руководству [Клонирование примера проекта Jaffle Shop](https://docs.getdbt.tech/guides/clone-jaffle-shop.md). Этот проект можно запустить; он содержит примеры конфигураций и полезные примечания.

Если вы хотите увидеть, как выглядит зрелый, производственный проект, ознакомьтесь с [публичным репозиторием команды данных GitLab](https://gitlab.com/gitlab-data/analytics/-/tree/master/transform/snowflake-dbt).

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

* [Лучшие практики: как мы структурируем наши проекты dbt](https://docs.getdbt.tech/best-practices/how-we-structure/1-guide-overview.md)
* [Руководства по быстрому старту с dbt](https://docs.getdbt.tech/guides.md)
* [Руководство по быстрому старту с dbt v1](https://docs.getdbt.tech/guides/manual-install.md)
