Deprecation: dbt Metrics and the legacy dbt Semantic Layer is now deprecated
dbt Labs has deprecated dbt Metrics and the legacy dbt Semantic Layer, both supported on dbt version 1.5 or lower. This change starts on December 15th, 2023.
This deprecation means dbt Metrics and the legacy Semantic Layer are no longer supported. We also removed the feature from the dbt Cloud user interface and documentation site.
Why this change?
The re-released dbt Semantic Layer, powered by MetricFlow, offers enhanced flexibility, performance, and user experience, marking a significant advancement for the dbt community.
Key changes and impact
- Deprecation date — The legacy Semantic Layer and dbt Metrics will be officially deprecated on December 15th, 2023.
- Replacement — MetricFlow replaces dbt Metrics for defining semantic logic. The
dbt_metrics
package will no longer be supported post-deprecation. - New feature — Exports replaces the materializing data with
metrics.calculate
functionality and will be available in dbt Cloud in December or January.
Breaking changes and recommendations
For users on dbt version 1.5 and lower with dbt Metrics and Snowflake proxy:
- Impact: Post-deprecation, queries using the proxy will not run.
- Action required: Immediate migration is necessary. Refer to the dbt Semantic Layer migration guide
For users on dbt version 1.5 and lower using dbt Metrics without Snowflake proxy:
- Impact: No immediate disruption, but the package will not receive updates or support after deprecation
- Recommendation: Plan migration to the re-released Semantic Layer for compatibility with dbt version 1.6 and higher.
Engage and support
- Feedback and community support — Engage and share feedback with the dbt Labs team and dbt Community slack using channels like #dbt-cloud-semantic-layer and #dbt-metricflow. Or reach out to your dbt Cloud account representative.
- Resources for upgrading — Refer to some additional info and resources to help you upgrade your dbt version:
0