Skip to main content

Migration guide for Utils

Upgrading to 1.0.0

  • Version 1.10.6 of dbt-core now required
  • for a full upgrade walkthrough, please follow official dbt guide
  • Generic test arguments must be nested under arguments: (see dbt’s guidance on the require_generic_test_arguments_property behavior change here)
  • Adapter dbt-redshift 1.10.0+ is required for Redshift users
  • Users unable to upgrade immediately may remain on v0.x, which receives critical bug fixes only

Upgrading to 0.14.0

  • Version 1.4.0 of dbt-core now required
  • Any custom models using the snowplow_incremental materialization should be changed to use the incremental materialization with snowplow_optimize=true set in the model config. snowplow_incremental has been deprecated
  • BigQuery incremental models now require the upsert_date_key config
  • snowplow_utils.type_string it has been deprecated and should be replaced with dbt.type_string() for non-length specific calls, and snowplow_utils.type_max_string for redshift strings above 256 characters.
  • snowplow_utils.get_cluster_by and snowplow_utils.get_partition_by they have been deprecated and should be replaced with snowplow_utils.get_value_by_target_type with arg names bigquery_val, databricks_val etc.
  • snowplow_utils.snowplow_is_incremental has been deprecated and should be replaced with standard is_incremental() to align with removal of the custom materialization
  • You must add the following to the top level of your project yaml to take advantage of our optimized incremental materialization
    ymldbt_project.yml
    dispatch:
    - macro_namespace: dbt
    search_order: ['snowplow_utils', 'dbt']

Upgrading to 0.13.0

  • Version 1.3.0 of dbt-core now required

On this page

Want to see a custom demo?

Our technical experts are here to help.