Skip to content

Commit

Permalink
v1.7 Migration Guide updates
Browse files Browse the repository at this point in the history
  • Loading branch information
matthewshaver committed Oct 9, 2023
1 parent 571abfc commit 5b1dd5f
Showing 1 changed file with 34 additions and 1 deletion.
35 changes: 34 additions & 1 deletion website/docs/guides/migration/versions/00-upgrading-to-v1.7.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,40 @@ dbt Labs is committed to providing backward compatibility for all versions 1.x,

**COMING SOON**

## New and changed documentation

- `dbt docs generate` now supports `--select` to generate documentation for a subset of your project
- currently Snowflake and Postgres only, but other adapters on their way

### source freshness can now be generated from warehouse metadata tables
- currently snowflake only, but other adapters that have metadata tables on their way
- if you configure source freshness without a `loaded_at_field`, dbt will try to determine freshness from warehouse metadata tables

### MetricFlow enhancements
- automatically create metrics on measures, `create_metric: true`
- optional `label` in semantic_models, measures, dimensions and
entities
- new configurations for semantic models - enable/disable, group, meta
- support `fill_nulls_with` and `join_to_timespine` for metric nodes
- `saved_queries` extend governance beyond the semantic objects to their consumption

## For consumers of dbt artifacts (metadata)

The [manifest](https://docs.getdbt.com/reference/artifacts/manifest-json) schema version has been updated to v11. Specific changes:
- ???

@dbeatty10 do you know what the manifest schema changes were? The [PR that bumped the version](https://github.com/dbt-labs/dbt-core/pull/8335) didn't seem to make any other changes.

The [run_results](https://docs.getdbt.com/reference/artifacts/run-results-json) schema version has been updated to v5. Specific changes:
- Add node attributes related to compilation (`compiled`, `compiled_code`, `relation_name`)

The nodes dictionary in the `catalog.json` can now be "partial" if `dbt docs generate` is run with a selector.

### Quick hits

**COMING SOON**
- You can configure a `delimiter` for a seed file.
- Allow setting `access` as a config.
- Support packages with same git repo and unique subdirectory.
- Moved `date_spine` macro from dbt-utils to dbt-core.


0 comments on commit 5b1dd5f

Please sign in to comment.