CHANGELOG.md

dbt-utils v0.6.0 (unreleased)

Breaking changes

• 🚨 dbt v0.18.0 or greater is required for this release. If you are not ready to upgrade, consider using a previous release of this package
• 🚨 The get_tables_by_prefix, union_tables and get_tables_by_pattern macros have been removed

Migration instructions

• Upgrade your dbt project to v0.18.0 using these instructions.
• Upgrade your dbt_project.yml file to use version 0.7.0. Run dbt clean and dbt deps.
• If your project uses the get_tables_by_prefix macro, replace it with get_relations_by_prefix. All arguments have retained the same name.
• If your project uses the union_tables macro, replace it with union_relations. While the order of arguments has stayed consistent, the tables argument has been renamed to relations. Further, the default value for the source_column_name argument has changed from '_dbt_source_table' to '_dbt_source_relation' — you may want to explicitly define this argument to avoid breaking changes.

-- before:
{{ dbt_utils.union_tables(
    tables=[ref('my_model'), source('my_source', 'my_table')],
    exclude=["_loaded_at"]
) }}

-- after:
{{ dbt_utils.union_relations(
    relations=[ref('my_model'), source('my_source', 'my_table')],
    exclude=["_loaded_at"],
    source_column_name='_dbt_source_table'
) }}

• If your project uses the get_tables_by_pattern macro, replace it with get_tables_by_pattern_sql — all arguments are consistent.

Fixes

Features

• Switch usage of adapter_macro to adapter.dispatch, and define dbt_utils_dispatch_list, enabling users of community-supported database plugins to add or override macro implementations specific to their database (#267)
• Use add_ephemeral_prefix instead of hard-coding a string literal, to support database adapters that use different prefixes (#267)

Quality of life

• Remove deprecated macros get_tables_by_prefix and union_tables (#268)
• Remove get_tables_by_pattern macro, which is equivalent to the get_tables_by_pattern_sql macro (the latter has a more logical name)

dbt-utils v0.5.1

Fixes

Features

Quality of life

• Improve release process, and fix tests (#251)
• Make deprecation warnings more useful (#258 @tayloramurphy)