The location of the dbt Core upgrade guides has changed, and they will soon be removed from
Guides. The new location is in the
Docs tab under
Available dbt versions. You have been redirected to the new URL, so please update any saved links and bookmarks.
What to know before upgrading
We are committed to providing backward compatibility for all versions 1.x. If you encounter an error upon upgrading, please let us know by opening an issue.
There are three changes in dbt Core v1.3 that may require action from some users:
- If you have a
profiles.ymlfile located in the root directory where you run dbt, dbt will start preferring that profiles file over the default location on your machine. You can read more details here.
- If you already have
.pyfiles defined in the
model-pathsof your dbt project, dbt will start trying to read them as Python models. You can use the new
.dbtignorefile to tell dbt to ignore those files.
- If you have custom code accessing the
raw_sqlproperty of models (with the model or graph objects), it has been renamed to
raw_code. This is a change to the manifest contract, described in more detail below.
For users of dbt Metrics
The names of metric properties have changed, with backward compatibility. Those changes are:
expressioncalculation method metrics to
derivedcalculation method metrics
We plan to keep backward compatibility for a full minor version. Defining metrics with the old names will raise an error in dbt Core v1.4.
For consumers of dbt artifacts (metadata)
We have updated the manifest schema version to
v7. This includes the changes to metrics described above and a few other changes related to the addition of Python models:
- A new top-level node property,
For users of state-based selection: This release includes logic providing backward and forward compatibility for older manifest versions. While running dbt Core v1.3, it should be possible to use
state:modified --state ... selection against a manifest produced by dbt Core v1.0 and higher.
For maintainers of adapter plugins
GitHub discussion with details: dbt-labs/dbt-core#6011
New and changed documentation
Python models are natively supported in
dbt-corefor the first time, on data warehouses that support Python runtimes.
Updates made to Metrics reflect their new syntax for definition, as well as additional properties that are now available.
Plus, a few related updates to exposure properties:
dbt-docs. For the first time, you can control the colors displayed in dbt's DAG. Want bronze, silver, and gold layers? It's at your fingertips.
Profiles.ymlsearch order now looks in the current working directory before