Перейти к основному содержимому

Обновление до версии v1.3

Ресурсы​

Что нужно знать перед обновлением​

Мы стремимся обеспечивать обратную совместимость для всех версий 1.x. Если вы столкнетесь с ошибкой при обновлении, пожалуйста, сообщите нам, создав задачу.

В dbt Core v1.3 есть три изменения, которые могут потребовать действий со стороны некоторых пользователей:

  1. Если у вас есть файл profiles.yml, расположенный в корневом каталоге, из которого вы запускаете dbt, dbt начнёт отдавать предпочтение этому файлу профилей по сравнению с расположением по умолчанию на вашей машине. Подробнее об этом можно прочитать здесь.
  2. Если в вашем dbt‑проекте в параметре model-paths уже указаны файлы с расширением .py, dbt начнёт пытаться читать их как Python‑модели. Вы можете использовать новый файл .dbtignore, чтобы указать dbt игнорировать такие файлы.
  3. Если у вас есть пользовательский код, который обращается к свойству raw_sql моделей (через объекты model или graph), оно было переименовано в raw_code. Это изменение контракта manifest, которое более подробно описано ниже.

Для пользователей dbt Metrics​

Названия свойств метрик изменились с сохранением обратной совместимости. Эти изменения:

  • Переименовано type в calculation_method
  • Переименовано sql в expression
  • Переименовано метрики метода вычисления expression в метрики метода вычисления derived

Мы планируем сохранять обратную совместимость в течение полного минорного релиза. Определение метрик со старыми именами будет приводить к ошибке в dbt Core v1.4.

Для потребителей артефактов dbt (метаданных)​

Мы обновили версию схемы манифеста до v7. Это включает изменения в метриках, описанные выше, и несколько других изменений, связанных с добавлением Python моделей:

  • Переименовано raw_sql в raw_code
  • Переименовано compiled_sql в compiled_code
  • Новое свойство узла верхнего уровня, language ('sql' или 'python')

Для пользователей выбора на основе состояния: Этот выпуск включает логику, обеспечивающую обратную и прямую совместимость для старых версий манифеста. При запуске dbt Core v1.3 должно быть возможно использовать выбор state:modified --state ... против манифеста, созданного dbt Core v1.0 и выше.

Для разработчиков адаптеров плагинов​

Обсуждение на GitHub с подробностями: dbt-labs/dbt-core#6011

Новая и измененная документация​

  • Python модели теперь поддерживаются нативно в dbt-core впервые, на хранилищах данных, поддерживающих Python среды выполнения.

  • Обновления, внесенные в Metrics, отражают их новый синтаксис для определения, а также дополнительные свойства, которые теперь доступны.

  • Плюс, несколько связанных обновлений свойств экспозиции: валидация config, label и name.

  • Пользовательский node_color в dbt-docs. Впервые вы можете контролировать цвета, отображаемые в DAG dbt. Хотите бронзовые, серебряные и золотые слои? Это в ваших руках.

  • Порядок поиска Profiles.yml теперь сначала проверяет текущий рабочий каталог перед ~/.dbt.

Быстрые изменения​

Нашли ошибку?

0
Loading