Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add new cookbook section with usecases #5757

Open
wants to merge 42 commits into
base: current
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
42 commits
Select commit Hold shift + click to select a range
ba00d63
add active users wow
mirnawong1 Jul 1, 2024
f4ef45d
add arr
mirnawong1 Jul 1, 2024
87adb47
add other metrics
mirnawong1 Jul 1, 2024
37ab1f4
add clarity
mirnawong1 Jul 9, 2024
4004039
update bits
mirnawong1 Jul 9, 2024
6a71482
fix formatting
mirnawong1 Jul 9, 2024
c5c027e
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Jul 9, 2024
e701e98
Update website/docs/guides/sl-cookbook-recipes.md
mirnawong1 Jul 9, 2024
0122bad
Update website/docs/guides/sl-cookbook-recipes.md
mirnawong1 Jul 19, 2024
a131f1a
Update website/docs/guides/sl-cookbook-recipes.md
mirnawong1 Jul 19, 2024
c8fd02c
Update website/docs/guides/sl-cookbook-recipes.md
mirnawong1 Jul 19, 2024
a1949d5
Update website/docs/guides/sl-cookbook-recipes.md
mirnawong1 Jul 30, 2024
e473d5e
Update sl-cookbook-recipes.md
mirnawong1 Jul 30, 2024
aa2b8d2
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Jul 30, 2024
958a886
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Jul 30, 2024
25f0821
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Aug 8, 2024
ce652e7
add more use cases and links
mirnawong1 Sep 5, 2024
834cd68
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 5, 2024
5b86527
add list of topics
mirnawong1 Sep 5, 2024
9283b72
Update website/docs/best-practices/how-we-build-our-metrics/semantic-…
mirnawong1 Sep 5, 2024
7e49e2e
Update website/docs/docs/build/about-metricflow.md
mirnawong1 Sep 5, 2024
9eb63b6
Update website/docs/docs/build/build-metrics-intro.md
mirnawong1 Sep 5, 2024
c106b82
Update website/docs/guides/sl-snowflake-qs.md
mirnawong1 Sep 5, 2024
ed0aab7
Update website/docs/docs/use-dbt-semantic-layer/setup-sl.md
mirnawong1 Sep 5, 2024
12c41ad
Update website/docs/docs/cloud-integrations/avail-sl-integrations.md
mirnawong1 Sep 5, 2024
9a30462
Update website/docs/docs/build/semantic-models.md
mirnawong1 Sep 5, 2024
5d60326
Update website/docs/docs/build/metrics-overview.md
mirnawong1 Sep 5, 2024
0a1dd5c
Update about-metricflow.md
mirnawong1 Sep 5, 2024
b4815cb
Update semantic-models.md
mirnawong1 Sep 5, 2024
33c675d
fix id
mirnawong1 Sep 5, 2024
148af93
Update website/docs/guides/sl-cookbook-recipes.md
mirnawong1 Sep 5, 2024
47a5a9e
fix links
mirnawong1 Sep 5, 2024
76ab6db
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 5, 2024
a40aba0
adjust tag
mirnawong1 Sep 5, 2024
fa46df7
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 6, 2024
92a8463
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 9, 2024
c4e9d6c
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 11, 2024
00610a1
Update website/docs/guides/sl-cookbook-recipes.md
mirnawong1 Sep 12, 2024
2e48442
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 12, 2024
78a53e9
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 24, 2024
4f59f8c
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 24, 2024
11f66e1
Merge branch 'current' into mwong-add-cookbook
mirnawong1 Sep 25, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,8 @@ pagination_next: null
- 🗺️ Use these best practices to map out your team's plan to **incrementally adopt the Semantic Layer**.
- 🤗 Get involved in the community and ask questions, **help craft best practices**, and share your progress in building a dbt Semantic Layer.
- [Validate semantic nodes in CI](/docs/deploy/ci-jobs#semantic-validations-in-ci) to ensure code changes made to dbt models don't break these metrics.

- [dbt Semantic Layer cookbook recipes](/guides/sl-cookbook-recipes) for more advanced use cases.

The dbt Semantic Layer is the biggest paradigm shift thus far in the young practice of analytics engineering. It's ready to provide value right away, but is most impactful if you move your project towards increasing normalization, and allow MetricFlow to do the denormalization for you with maximum dimensionality.

We will be releasing more resources soon covering implementation of the Semantic Layer in dbt Cloud with various integrated BI tools. This is just the beginning, hopefully this guide has given you a path forward for building your data platform in this new era. Refer to [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs) for more information.
2 changes: 2 additions & 0 deletions website/docs/docs/build/about-metricflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -283,5 +283,7 @@ Yes, but because a dimension is considered an attribute of the primary or unique
</DetailsToggle>

## Related docs

- [dbt Semantic Layer cookbook recipes](/guides/sl-cookbook-recipes)
- [Joins](/docs/build/join-logic)
- [Validations](/docs/build/validation)
1 change: 1 addition & 0 deletions website/docs/docs/build/build-metrics-intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,7 @@ MetricFlow allows you to:

## Related docs

- [dbt Semantic Layer cookbook recipes](/guides/sl-cookbook-recipes)
- [Quickstart guide with the dbt Semantic Layer](/guides/sl-snowflake-qs)
- [The dbt Semantic Layer: what's next](https://www.getdbt.com/blog/dbt-semantic-layer-whats-next/) blog
- [dbt Semantic Layer on-demand course](https://learn.getdbt.com/courses/semantic-layer)
Expand Down
1 change: 1 addition & 0 deletions website/docs/docs/build/metrics-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -307,3 +307,4 @@ You can set more metadata for your metrics, which can be used by other tools lat
- [Semantic models](/docs/build/semantic-models)
- [Fill null values for metrics](/docs/build/fill-nulls-advanced)
- [Metrics as dimensions with metric filters](/docs/build/ref-metrics-in-filters)
- [dbt Semantic Layer cookbook recipes](/guides/sl-cookbook-recipes)
1 change: 1 addition & 0 deletions website/docs/docs/build/semantic-models.md
Original file line number Diff line number Diff line change
Expand Up @@ -264,3 +264,4 @@ import SetUpPages from '/snippets/\_metrics-dependencies.md';
- [Entities](/docs/build/entities)
- [Measures](/docs/build/measures)
- [Semantic Layer best practices guide](/best-practices/how-we-build-our-metrics/semantic-layer-1-intro)
- [dbt Semantic Layer cookbook recipes](/guides/sl-cookbook-recipes)
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ import AvailIntegrations from '/snippets/_sl-partner-links.md';
## Related docs

- <span><a href="https://docs.getdbt.com/docs/dbt-cloud-apis/sl-api-overview" target="_self">{frontMatter.meta.api_name}</a></span> to learn how to integrate and query your metrics in downstream tools.
- [dbt Semantic Layer cookbook recipes](/guides/sl-cookbook-recipes)
- [dbt Semantic Layer API query syntax](/docs/dbt-cloud-apis/sl-jdbc#querying-the-api-for-metric-metadata)
- [Hex dbt Semantic Layer cells](https://learn.hex.tech/docs/logic-cell-types/transform-cells/dbt-metrics-cells) to set up SQL cells in Hex.
- [Resolve 'Failed APN'](/faqs/Troubleshooting/sl-alpn-error) error when connecting to the dbt Semantic Layer.
Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/use-dbt-semantic-layer/dbt-sl.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ The dbt Semantic Layer, powered by [MetricFlow](/docs/build/about-metricflow), s

Moving metric definitions out of the BI layer and into the modeling layer allows data teams to feel confident that different business units are working from the same metric definitions, regardless of their tool of choice. If a metric definition changes in dbt, it’s refreshed everywhere it’s invoked and creates consistency across all applications. To ensure secure access control, the dbt Semantic Layer implements robust [access permissions](/docs/use-dbt-semantic-layer/setup-sl#set-up-dbt-semantic-layer) mechanisms.

Refer to the [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs) or [Why we need a universal semantic layer](https://www.getdbt.com/blog/universal-semantic-layer/) blog post to learn more.
Refer to the [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs) or [Why we need a universal semantic layer](https://www.getdbt.com/blog/universal-semantic-layer/) blog post to learn more.

## Get started with the dbt Semantic Layer

Expand Down
1 change: 1 addition & 0 deletions website/docs/docs/use-dbt-semantic-layer/setup-sl.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,7 @@ import SlSetUp from '/snippets/_new-sl-setup.md';
- [Validate semantic nodes in CI](/docs/deploy/ci-jobs#semantic-validations-in-ci) to ensure code changes made to dbt models don't break these metrics.
- If you haven't already, learn how to [build you metrics and semantic models](/docs/build/build-metrics-intro) in your development tool of choice.
- Learn about commonly asked [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs).
- [dbt Semantic Layer cookbook recipes](/guides/sl-cookbook-recipes) for more advanced use cases.

## FAQs

Expand Down
Loading
Loading