Проверка совместимости версий

В первые несколько лет разработки dbt Core изменения, нарушающие совместимость, были более частыми. По этой причине мы рекомендовали устанавливать требования к версии dbt — особенно если используются функции, которые являются новыми или могут измениться в будущих версиях dbt Core. По умолчанию, если вы запускаете проект с несовместимой версией dbt, dbt выдаст ошибку.

Вы можете использовать конфигурацию VERSION_CHECK, чтобы отключить эту проверку и подавить сообщение об ошибке:

dbt --no-version-check run
Running with dbt=1.0.0
Found 13 models, 2 tests, 1 archives, 0 analyses, 204 macros, 2 operations....

Выпуски dbt Cloud

Начиная с 2024 года, когда вы выбираете трассу обновлений в dbt Cloud для получения постоянных обновлений версии dbt, dbt будет игнорировать конфигурацию require-dbt-version.

dbt Labs стремится к отсутствию критических изменений для кода в проектах dbt, с постоянными релизами в dbt Cloud и новыми версиями dbt Core. Мы также рекомендуем следующие лучшие практики:

 Установка пакетов dbt

Если вы устанавливаете пакеты dbt для использования в вашем проекте, будь то пакет, поддерживаемый вашими коллегами или членом сообщества с открытым исходным кодом dbt, мы рекомендуем закрепить пакет на определенной ревизии или границе version. Начиная с версии v1.7, dbt управляет этим из коробки, блокируя версию/ревизию пакетов в разработке, чтобы гарантировать предсказуемые сборки в производстве. Чтобы узнать больше, обратитесь к Предсказуемая установка пакетов.

 Поддержка пакетов dbt

Если вы поддерживаете пакеты dbt, будь то от имени ваших коллег или членов сообщества с открытым исходным кодом, мы рекомендуем писать защитный код, который проверяет наличие других необходимых пакетов и глобальных макросов. Например, если ваш пакет зависит от наличия макроса date_spine в глобальном пространстве имен dbt, вы можете написать:

models/some_days.sql

{% macro a_few_days_in_september() %}

    {% if not dbt.get('date_spine') %}
      {{ exceptions.raise_compiler_error("Expected to find the dbt.date_spine macro, but it could not be found") }}
    {% endif %}

    {{ date_spine("day", "cast('2020-01-01' as date)", "cast('2030-12-31' as date)") }}

{% endmacro %}