dbt 0.9.0

dbt 0.9.0

This release focuses on improvements to macros, materializations, and package management. Check out the blog post to learn more about what's possible in this new version of dbt.

Installation

Full installation instructions for macOS, Windows, and Linux can be found here. If you use Windows or Linux, installation works the same as with previous versions of dbt. If you use macOS and Homebrew to install dbt, note that installation instructions have changed:

macOS Installation Instructions

brew update
brew tap fishtown-analytics/dbt
brew install dbt

Overview

• More powerful macros and materializations
• Custom model schemas
• BigQuery improvements
• Bugfixes
• Documentation (0.9.0 docs can be found here)

Breaking Changes

• adapter functions must be namespaced to the adapter context variable. To fix this error, use adapter.already_exists instead of just already_exists, or similar for other adapter functions.

Bugfixes

• Handle lingering __dbt_tmp relations (#511)
• Run tests defined in an ephemeral directory (#509)

Changes

• use adapter, ref, and var inside of macros (#466)
• Build custom tests and materializations in dbt packages (#466)
• Support pre- and post- hooks that run outside of a transaction (#510)
• Support table materializations for BigQuery (#507)
• Support querying external data sources in BigQuery (#507)
• Override which schema models are materialized in (#522) (docs)
• Make {{ ref(...) }} return the same type of object as {{ this }} (#530)
• Replace schema test CTEs with subqueries to speed them up for Postgres (#536) (@ronnyli)
• Bump Snowflake dependency, remove pyasn1 (#570)

Documentation

• Document how to create a package
• Document how to make a materialization
• Document how to make custom schema tests
• Document how to use hooks to vacuum
• Document all context variables

New Contributors

• @ronnyli (#536)

And one more thing

Questions? Comments? Suggestions? We want to hear them! If you haven't already, join our vibrant and bustling slack team 📈

dbt 0.9.0 alpha 2

dbt 0.9.0 alpha 2

This is the second alpha version of the dbt 0.9.0 release. It may contain bugs or incompatibilities with previous versions of dbt. Please reach out to us on Slack or create an issue if you have any questions or find any such bugs.

Over the next few weeks, we (and hopefully you) will put dbt through its paces, fixing bugs or tweaking features as required. When we're happy with the results, we will release dbt v0.9.0 through the regular channels including pypi, homebrew, and conda. If you're interested in using the alpha preview in the meantime, you can do so using the installation instructions below.

Changelog

Check out the changelog here

Installation

Since this is an alpha release, package managers like homebrew, pip and conda will still point to the last production release, dbt v0.8.3. To install dbt v0.9.0a2, you must either install this version explicitly from pip, or install from source.

Installing from pip

Note: we recommend that you install dbt into a virtualenv. While this isn't necessary, it may save you a headache if you choose to roll back to 0.8.3, or when the time comes to upgrade to the final 0.9.0 release.

1. Uninstall any existing versions of dbt brew uninstall dbt, pip uninstall dbt, etc
2. Run pip install dbt==0.9.0a2

Installing from source

git clone git@github.com:fishtown-analytics/dbt.git
cd dbt
git fetch --tags
git checkout tags/v0.9.0a2
pip install -e .

Verify your installation

Regardless of the method you've chosen, run:

dbt --version

to confirm that your installed version of dbt is 0.9.0a2

One more thing

As always, feel free to reach out to us on Slack with any questions or comments!

dbt 0.9.0 alpha 1

dbt 0.9.0 alpha 1

This is an alpha version of the dbt 0.9.0 release. It may contain bugs or incompatibilities with previous versions of dbt. Please reach out to us on Slack or create an issue if you have any questions or find any such bugs.

Over the next few weeks, we (and hopefully you) will put dbt through its paces, fixing bugs or tweaking features as required. When we're happy with the results, we will release dbt v0.9.0 through the regular channels including pypi, homebrew, and conda. If you're interested in using the alpha preview in the meantime, you can do so using the installation instructions below.

Changelog

Check out the changelog here

Installation

Since this is an alpha release, package managers like homebrew, pip and conda will still point to the last production release, dbt v0.8.3. To install dbt v0.9.0a1, you must either install this version explicitly from pip, or install from source.

Installing from pip

Note: we recommend that you install dbt into a virtualenv. While this isn't necessary, it may save you a headache if you choose to roll back to 0.8.3, or when the time comes to upgrade to the final 0.9.0 release.

1. Uninstall any existing versions of dbt brew uninstall dbt, pip uninstall dbt, etc
2. Run pip install dbt==0.9.0a1

Installing from source

git clone git@github.com:fishtown-analytics/dbt.git
cd dbt
git fetch --tags
git checkout tags/v0.9.0a1
pip install -e .

Verify your installation

Regardless of the method you've chosen, run:

dbt --version

to confirm that your installed version of dbt is 0.9.0a1

One more thing

As always, feel free to reach out to us on Slack with any questions or comments!

dbt 0.8.3

dbt 0.8.3

Check out the release notes here

One more thing

As always, feel free to reach out to us on Slack with any questions or comments!

dbt 0.8.2

dbt 0.8.2

Check out the release notes here

One more thing

As always, feel free to reach out to us on Slack with any questions or comments!

dbt 0.8.1

dbt 0.8.1

Check out the release notes here

One more thing

As always, feel free to reach out to us on Slack with any questions or comments!

dbt 0.8.0

dbt 0.8.0

Check out the release notes here

One more thing

As always, feel free to reach out to us on Slack with any questions or comments!

dbt 0.7.1

dbt 0.7.1

Check out the release notes here

Note

This version of dbt changes the semantics of the --models argument to dbt run and dbt test. Be sure to check out the new functionality here under "Specifying models to run"!

One more thing

As always, feel free to reach out to us on Slack with any questions or comments!

dbt 0.7.0

dbt 0.7.0

Check out the release notes here

As always, feel free to reach out to us on Slack with any questions or comments!

dbt 0.6.2

dbt 0.6.2

Check out the release notes here

As always, feel free to reach out to us on Slack with any questions or comments!