From 00dbb37aaf34eaed9ce7db32ea38b730149da62f Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 26 Apr 2024 15:33:52 +0100 Subject: [PATCH 1/6] create apr sl rn --- .../release-notes/70-Apr-2024/apr-sl.md | 39 +++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md diff --git a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md new file mode 100644 index 00000000000..bca360b0b02 --- /dev/null +++ b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md @@ -0,0 +1,39 @@ +--- +title: "dbt Semantic Layer updates and fixes for April 2024" +description: "Apr 2024: Enhanced Google Sheets integration include new features for metric labels, saved selections, and time filters. Tableau integration improvements include data source update and bug fixes." +sidebar_label: "Updates and fixes: dbt Semantic Layer" +sidebar_position: 06 +tags: [Apr-2024] +date: 2024-04-30 +--- + +The dbt Labs team continues to work on adding new features, fixing bugs, and increasing reliability for the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) and [MetricFlow](/docs/build/about-metricflow). This release note includes our work in April 2024: + +## New features + +**Google Sheets** +- **Saved selections** — You can save your query selections within the Google Sheets application. They can be made private or public and refresh upon loading. +- **Display metric label** — Metrics are now displayed by their labels as `metric_name`. + +## Updates + +- **Metadata in metrics** — [Metrics](/docs/build/metrics-overview) now supports the [`meta` option](/reference/resource-configs/meta) under the [config](/reference/resource-properties/config) property. Previously, we only supported the now deprecated `meta` tag. + +**Google Sheets** + +- **Explore saved queries** — Added support for functionality allowing for jumping off from or exploring MetricFlow-defined saved queries directly. +- **Query dimensions** — Added support to query dimensions without metrics. Previously, you needed a dimension. +- Time filters — Added support for time presets and complex time range filters such as "between", "after", and "before". +- **Dimension value population** — Added supported to automatically populate dimension values when you select a "where" filter, removing the need to manually type them. Previously, you needed to manually type the dimension values. +- **Entity querying** — Added support to directly query entities, expanding the flexibility of data requests. +- **Exclude column headers** — Added an option to exclude column headers, which is useful for populating templates with only the required data. + +## Deprecation + +**Tableau** + +- **`METRICS_AND_DIMENSIONS`** — This data source is deprecated for all accounts not actively using it. We encourage users to transition to the "ALL" data source for future integrations. + +## Bugs +**Tableau** +- **Tableau errors** — NEED MORE INFO FROM DIEGO From aef5a8857fdc9a164b9b1ab434df6e81ef07c773 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 26 Apr 2024 15:39:05 +0100 Subject: [PATCH 2/6] update tableau --- .../docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md | 4 ++-- website/docs/docs/use-dbt-semantic-layer/tableau.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md index bca360b0b02..89263d98549 100644 --- a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md +++ b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md @@ -12,7 +12,7 @@ The dbt Labs team continues to work on adding new features, fixing bugs, and inc ## New features **Google Sheets** -- **Saved selections** — You can save your query selections within the Google Sheets application. They can be made private or public and refresh upon loading. +- **Saved selections** — You can [save your query selections](/docs/use-dbt-semantic-layer/gsheets#using-saved-selections) within the Google Sheets application. They can be made private or public and refresh upon loading. - **Display metric label** — Metrics are now displayed by their labels as `metric_name`. ## Updates @@ -21,7 +21,7 @@ The dbt Labs team continues to work on adding new features, fixing bugs, and inc **Google Sheets** -- **Explore saved queries** — Added support for functionality allowing for jumping off from or exploring MetricFlow-defined saved queries directly. +- **Explore saved queries** — Added [support](/docs/use-dbt-semantic-layer/gsheets#using-saved-queries) to allow jumping off from or exploring MetricFlow-defined saved queries directly. - **Query dimensions** — Added support to query dimensions without metrics. Previously, you needed a dimension. - Time filters — Added support for time presets and complex time range filters such as "between", "after", and "before". - **Dimension value population** — Added supported to automatically populate dimension values when you select a "where" filter, removing the need to manually type them. Previously, you needed to manually type the dimension values. diff --git a/website/docs/docs/use-dbt-semantic-layer/tableau.md b/website/docs/docs/use-dbt-semantic-layer/tableau.md index 9cd0ce2d832..cd2339451fe 100644 --- a/website/docs/docs/use-dbt-semantic-layer/tableau.md +++ b/website/docs/docs/use-dbt-semantic-layer/tableau.md @@ -44,8 +44,8 @@ import SLCourses from '/snippets/_sl-course.md'; ## Using the integration -1. **Authentication** — Once you authenticate, the system will direct you to the data source page. -2. **Access all Semantic Layer Objects** — You can choose between all the metrics, dimensions, and entities configured in your dbt Semantic Layer under the data source called "ALL". (Note: "METRICS_AND_DIMENSIONS" was the original name of this data source, and it contains the same information as "ALL". In the future, we will deprecate "METRICS_AND_DIMENSIONS" in favor of "ALL") +1. **Authentication** — Once you authenticate, the system will direct you to the data source page. +2. **Access all Semantic Layer Objects** — Use the "ALL" data source to access all the metrics, dimensions, and entities configured in your dbt Semantic Layer. Note that the "METRICS_AND_DIMENSIONS" data source has been deprecated and replaced by "ALL". 3. **Access saved queries** — You can optionally access individual [saved queries](/docs/build/saved-queries) that you've defined. These will also show up as unique data sources when you log in. 4. **Access worksheet** — From your data source selection, go directly to a worksheet in the bottom left-hand corner. 5. **Query metrics and dimensions** — Then, you'll find all the metrics, dimensions, and entities that are available to query on the left side of your window based on your selection. From 40fc6f52cb3b9f3c97544ebabdce78fd9e296b12 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Tue, 30 Apr 2024 18:13:18 +0100 Subject: [PATCH 3/6] adding to the soft launch rn page too --- .../docs/dbt-versions/2024-release-notes.md | 13 ++++++++++++- .../release-notes/70-Apr-2024/apr-sl.md | 19 ++++++++++--------- 2 files changed, 22 insertions(+), 10 deletions(-) diff --git a/website/docs/docs/dbt-versions/2024-release-notes.md b/website/docs/docs/dbt-versions/2024-release-notes.md index 1f757361158..a381d7f49de 100644 --- a/website/docs/docs/dbt-versions/2024-release-notes.md +++ b/website/docs/docs/dbt-versions/2024-release-notes.md @@ -21,6 +21,17 @@ dbt Cloud release notes for 2024. +**dbt Semantic Layer** +- **New**: Use Saved selections to [save your query selections](/docs/use-dbt-semantic-layer/gsheets#using-saved-selections) within the [Google Sheets application](/docs/use-dbt-semantic-layer/gsheets). They can be made private or public and refresh upon loading. +- **New**: Metrics are now displayed by their labels as `metric_name`. +- **Enhancement**: [Metrics](/docs/build/metrics-overview) now supports the [`meta` option](/reference/resource-configs/meta) under the [config](/reference/resource-properties/config) property. Previously, we only supported the now deprecated `meta` tag. +- **Enhancement**: In the Google Sheets application, we added [support](/docs/use-dbt-semantic-layer/gsheets#using-saved-queries) to allow jumping off from or exploring MetricFlow-defined saved queries directly. +- **Enhancement**: In the Google Sheets application, we added support to query dimensions without metrics. Previously, you needed a dimension. +- **Enhancement**: In the Google Sheets application, we added support for time presets and complex time range filters such as "between", "after", and "before". +- **Enhancement**: In the Google Sheets application, we added supported to automatically populate dimension values when you select a "where" filter, removing the need to manually type them. Previously, you needed to manually type the dimension values. +- **Enhancement**: In the Google Sheets application, we added support to directly query entities, expanding the flexibility of data requests. +- **Enhancement**: In the Google Sheets application, we added an option to exclude column headers, which is useful for populating templates with only the required data. +- **Deprecation**: For the Tableau integration, the [`METRICS_AND_DIMENSIONS` data source](/docs/use-dbt-semantic-layer/tableau#using-the-integration) has been deprecated for all accounts not actively using it. We encourage users to transition to the "ALL" data source for future integrations. ## March 2024 @@ -192,4 +203,4 @@ dbt Cloud release notes for 2024. - **Fix:** We now preserve dimension values accurately instead of being inadvertently converted into strings. - **Fix:** Resolved issues with naming collisions in queries involving multiple derived metrics using the same metric input. Previously, this could cause a naming collision. Input metrics are now deduplicated, ensuring each is referenced only once. - **Fix:** Resolved warnings related to using two duplicate input measures in a derived metric. Previously, this would trigger a warning. Input measures are now deduplicated, enhancing query processing and clarity. -- **Fix:** Resolved an error where referencing an entity in a filter using the object syntax would fail. For example, `{{Entity('entity_name')}}` would fail to resolve. \ No newline at end of file +- **Fix:** Resolved an error where referencing an entity in a filter using the object syntax would fail. For example, `{{Entity('entity_name')}}` would fail to resolve. diff --git a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md index 89263d98549..c254a28eee7 100644 --- a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md +++ b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md @@ -7,15 +7,19 @@ tags: [Apr-2024] date: 2024-04-30 --- -The dbt Labs team continues to work on adding new features, fixing bugs, and increasing reliability for the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) and [MetricFlow](/docs/build/about-metricflow). This release note includes our work in April 2024: +The dbt Labs team continues to work on adding new features, fixing bugs, and increasing reliability for the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) and [MetricFlow](/docs/build/about-metricflow). This release note includes fixes, updates, and deprecations for in April 2024. -## New features +:::info Updated release note layout +We've updated the layout of our release notes to provide a single view of the changes. Check out the [updated layout](/docs/dbt-versions/2024-release-notes) and [let us know what you think!](https://getdbt.slack.com/archives/C0441GSRU04) +::: + +### New features **Google Sheets** -- **Saved selections** — You can [save your query selections](/docs/use-dbt-semantic-layer/gsheets#using-saved-selections) within the Google Sheets application. They can be made private or public and refresh upon loading. +- **Saved selections** — You can [save your query selections](/docs/use-dbt-semantic-layer/gsheets#using-saved-selections) within the [Google Sheets application](/docs/use-dbt-semantic-layer/gsheets). They can be made private or public and refresh upon loading. - **Display metric label** — Metrics are now displayed by their labels as `metric_name`. -## Updates +### Updates - **Metadata in metrics** — [Metrics](/docs/build/metrics-overview) now supports the [`meta` option](/reference/resource-configs/meta) under the [config](/reference/resource-properties/config) property. Previously, we only supported the now deprecated `meta` tag. @@ -28,12 +32,9 @@ The dbt Labs team continues to work on adding new features, fixing bugs, and inc - **Entity querying** — Added support to directly query entities, expanding the flexibility of data requests. - **Exclude column headers** — Added an option to exclude column headers, which is useful for populating templates with only the required data. -## Deprecation +### Deprecation **Tableau** -- **`METRICS_AND_DIMENSIONS`** — This data source is deprecated for all accounts not actively using it. We encourage users to transition to the "ALL" data source for future integrations. +- **`METRICS_AND_DIMENSIONS`** — The [`METRICS_AND_DIMENSIONS` data source](/docs/use-dbt-semantic-layer/tableau#using-the-integration) has been [deprecated](/docs/use-dbt-semantic-layer/tableau#using-the-integration) for all accounts not actively using it. We encourage users to transition to the "ALL" data source for future integrations. -## Bugs -**Tableau** -- **Tableau errors** — NEED MORE INFO FROM DIEGO From 824f650278c2513b6536dae3fa818b1127458ebe Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Tue, 30 Apr 2024 18:27:46 +0100 Subject: [PATCH 4/6] update --- .../docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md index c254a28eee7..083d4c7043f 100644 --- a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md +++ b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md @@ -10,7 +10,7 @@ date: 2024-04-30 The dbt Labs team continues to work on adding new features, fixing bugs, and increasing reliability for the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) and [MetricFlow](/docs/build/about-metricflow). This release note includes fixes, updates, and deprecations for in April 2024. :::info Updated release note layout -We've updated the layout of our release notes to provide a single view of the changes. Check out the [updated layout](/docs/dbt-versions/2024-release-notes) and [let us know what you think!](https://getdbt.slack.com/archives/C0441GSRU04) +We've updated the layout of our release notes to provide a single view of the changes. Check out the [updated layout](/docs/dbt-versions/2024-release-notes) and let us know what you think by [opening up a GitHub issue](https://github.com/dbt-labs/docs.getdbt.com/issues)! ::: ### New features From 13a2e13c0db2ecb103c5a560e2e76807b0bf2703 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Tue, 30 Apr 2024 12:30:06 -0700 Subject: [PATCH 5/6] Update website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md --- .../docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md index 083d4c7043f..bbe4150e9b7 100644 --- a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md +++ b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md @@ -10,7 +10,7 @@ date: 2024-04-30 The dbt Labs team continues to work on adding new features, fixing bugs, and increasing reliability for the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) and [MetricFlow](/docs/build/about-metricflow). This release note includes fixes, updates, and deprecations for in April 2024. :::info Updated release note layout -We've updated the layout of our release notes to provide a single view of the changes. Check out the [updated layout](/docs/dbt-versions/2024-release-notes) and let us know what you think by [opening up a GitHub issue](https://github.com/dbt-labs/docs.getdbt.com/issues)! +We've updated the layout of our release notes to provide a single view of the changes. Check out the [updated layout](/docs/dbt-versions/2024-release-notes) and let us know of any problems by [opening up a GitHub issue](https://github.com/dbt-labs/docs.getdbt.com/issues)! ::: ### New features From 6b9f1ff3214e862fa20f32083736fcbd9efd5058 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 30 Apr 2024 21:07:41 +0100 Subject: [PATCH 6/6] Update apr-sl.md --- .../docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md index bbe4150e9b7..e2d94a39bb4 100644 --- a/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md +++ b/website/docs/docs/dbt-versions/release-notes/70-Apr-2024/apr-sl.md @@ -1,6 +1,6 @@ --- title: "dbt Semantic Layer updates and fixes for April 2024" -description: "Apr 2024: Enhanced Google Sheets integration include new features for metric labels, saved selections, and time filters. Tableau integration improvements include data source update and bug fixes." +description: "Apr 2024: Enhanced Google Sheets integration include new features for metric labels, saved selections, and time filters. Tableau integration improvements include data source updates." sidebar_label: "Updates and fixes: dbt Semantic Layer" sidebar_position: 06 tags: [Apr-2024]