Флаги проекта
dbt_project.yml
flags:
<global_config>: <value>
Обратитесь к таблице всех флагов, чтобы увидеть, какие глобальные конфигурации доступны для установки в dbt_project.yml.
Словарь flags — это единственное место, где вы можете отказаться от изменений поведения, пока поддерживается устаревшее поведение.
Приоритет конфигурации
Существует несколько способов настройки флагов в зависимости от сценария использования:
- Параметры CLI: Определяют поведение для конкретного вызова. Поддерживаются для всех команд dbt.
- Переменные окружения: Определяют различное поведение в разных средах выполнения (разработка, промышленная эксплуатация или непрерывная интеграция) или для разных пользователей в среде разработки (на основе личных предпочтений).
- Флаги
flagsна уровне проекта вdbt_project.yml: Определяют значения по умолчанию, хранящиеся в системе контроля версий, для всех, кто запускает этот проект. Также позволяют включать или отключать изменения поведения, чтобы управлять переходом с устаревшей функциональности. - Пользовательские настройки (
~/.dbt/user_settings.yml): Определяют личные предпочтения, которые применяются ко всем проектам на вашем компьютере. Записываются автоматически командойdbt login.
Наиболее конкретная настройка имеет приоритет. Наивысший приоритет имеют параметры CLI, затем идут переменные окружения, далее — dbt_project.yml и, наконец, user_settings.yml. Если флаг не задан ни в одном из этих мест, используется значение по умолчанию, определённое в dbt.
# dbt_project.yml
flags:
# значение по умолчанию для запуска этого проекта — везде, всегда, для всех
fail_fast: true
# установите для этой переменной окружения значение 'True' (синтаксис bash)
export DBT_ENGINE_FAIL_FAST=1
dbt run
dbt run --fail-fast # установить True для этого конкретного запуска
dbt run --no-fail-fast # установить False
Есть две категории исключений:
- Флаги, задающие пути к файлам: Флаги для путей к файлам, используемых во время выполнения (например,
--log-pathили--state), нельзя задавать вdbt_project.yml. Чтобы переопределить значения по умолчанию, передайте параметры CLI или задайте переменные окружения ((Версии dbt: v1.11 и новее)DBT_ENGINE_LOG_PATHиDBT_ENGINE_STATE). Флаги, указывающие dbt, где искать ресурсы проекта (например,model-paths), задаются вdbt_project.yml, но в виде ключей верхнего уровня, вне словаряflags; эти настройки должны быть полностью статичными и никогда не меняться в зависимости от команды или среды выполнения. - Флаги включения изменений поведения: Флаги, включающие или отключающие изменения поведения, можно задавать только в
dbt_project.yml. Предполагается, что они задаются в системе контроля версий и изменяются через запросы на слияние (pull/merge request). Их значения не должны оставаться различными для разных запусков, сред или пользователей в течение неопределённо долгого времени.
Нашли ошибку?
0