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

SL x snowflake guide #5242

Merged
merged 67 commits into from
Apr 19, 2024
Merged
Show file tree
Hide file tree
Changes from 63 commits
Commits
Show all changes
67 commits
Select commit Hold shift + click to select a range
3e3ba99
add
mirnawong1 Apr 5, 2024
5b8cf50
updates
mirnawong1 Apr 5, 2024
b180106
updates
mirnawong1 Apr 5, 2024
5973314
updates
mirnawong1 Apr 5, 2024
598f372
updates
mirnawong1 Apr 5, 2024
43956d8
fix
mirnawong1 Apr 8, 2024
3173661
updates
mirnawong1 Apr 8, 2024
dd9094b
updates
mirnawong1 Apr 8, 2024
1198351
updates
mirnawong1 Apr 8, 2024
4d97e5c
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 8, 2024
facb4e3
Update _sl-test-and-query-metrics.md
mirnawong1 Apr 8, 2024
07c61cd
add cloud
mirnawong1 Apr 8, 2024
51b4b94
Merge branch 'update-sl-guide' of https://github.com/dbt-labs/docs.ge…
mirnawong1 Apr 8, 2024
cc5c0d8
fix links
mirnawong1 Apr 8, 2024
76f14b3
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 8, 2024
4ac0572
update
mirnawong1 Apr 8, 2024
f4e0ae9
update id
mirnawong1 Apr 8, 2024
7d229c1
fix links
mirnawong1 Apr 8, 2024
3356246
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 9, 2024
93a97c0
updates
mirnawong1 Apr 9, 2024
c09437e
update
mirnawong1 Apr 9, 2024
4c7fd34
update links
mirnawong1 Apr 9, 2024
2702d03
fix links
mirnawong1 Apr 9, 2024
1e8af90
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 9, 2024
107cd13
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 9, 2024
8542d96
Update sl-snowflake-qs.md
mirnawong1 Apr 9, 2024
9ad30cb
Update sl-snowflake-qs.md
mirnawong1 Apr 9, 2024
b0f524b
Update sl-snowflake-qs.md
mirnawong1 Apr 9, 2024
078af49
Update _sl-test-and-query-metrics.md
mirnawong1 Apr 9, 2024
d5431fe
Update _sl-test-and-query-metrics.md
mirnawong1 Apr 9, 2024
9ef5653
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 10, 2024
cfb023b
Update build-metrics-intro.md
mirnawong1 Apr 10, 2024
51c35fe
Update website/docs/docs/use-dbt-semantic-layer/dbt-sl.md
mirnawong1 Apr 10, 2024
c2bc924
Update website/docs/docs/use-dbt-semantic-layer/sl-faqs.md
mirnawong1 Apr 10, 2024
81770ea
Update website/docs/guides/sl-snowflake-qs.md
mirnawong1 Apr 10, 2024
87e67ab
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 10, 2024
b9c69ac
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 12, 2024
e014697
FIX CODE
mirnawong1 Apr 12, 2024
45f1149
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 12, 2024
2a9dc75
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 15, 2024
aa3a6ba
Update website/docs/guides/sl-snowflake-qs.md
mirnawong1 Apr 15, 2024
9018fed
Update website/snippets/_sl-test-and-query-metrics.md
mirnawong1 Apr 15, 2024
cb65dcc
Update website/snippets/_sl-run-prod-job.md
mirnawong1 Apr 15, 2024
3ff93d8
Update website/docs/guides/sl-snowflake-qs.md
mirnawong1 Apr 15, 2024
8af9467
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 16, 2024
50ca865
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 17, 2024
f04762b
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 18, 2024
06968bb
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 18, 2024
fc06a8d
Update sl-snowflake-qs.md
mirnawong1 Apr 18, 2024
4330a85
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 18, 2024
490b1d8
Minor nits to first 3 steps
nghi-ly Apr 18, 2024
6b2a6db
add img
mirnawong1 Apr 18, 2024
831eb28
Merge branch 'update-sl-guide' of https://github.com/dbt-labs/docs.ge…
mirnawong1 Apr 18, 2024
89cfa40
Minor nits
nghi-ly Apr 18, 2024
84fffa8
Merge branch 'update-sl-guide' of github.com:dbt-labs/docs.getdbt.com…
nghi-ly Apr 18, 2024
0541794
Minor nits for review of step page 8
nghi-ly Apr 18, 2024
8d5613b
Merge branch 'current' into update-sl-guide
nghi-ly Apr 18, 2024
e03555e
Nits for step pages 8 - 10
nghi-ly Apr 18, 2024
66e362c
Merge branch 'current' into update-sl-guide
nghi-ly Apr 18, 2024
98eed12
Merge branch 'update-sl-guide' of github.com:dbt-labs/docs.getdbt.com…
nghi-ly Apr 18, 2024
6a66054
Nits for step pages 11 - 13
nghi-ly Apr 18, 2024
3327df2
Minor nits for step pages 14 -16
nghi-ly Apr 18, 2024
7c6b9c1
Merge branch 'current' into update-sl-guide
mirnawong1 Apr 19, 2024
bfa5d80
final updates
mirnawong1 Apr 19, 2024
b253564
update size
mirnawong1 Apr 19, 2024
650fe55
final twweaks
mirnawong1 Apr 19, 2024
c444f6b
update
mirnawong1 Apr 19, 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
5 changes: 2 additions & 3 deletions website/docs/docs/build/about-metricflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ pagination_next: "docs/build/join-logic"
pagination_prev: null
---

This guide introduces MetricFlow's fundamental ideas for people new to this feature. MetricFlow, which powers the dbt Semantic Layer, helps you define and manage the logic for your company's metrics. It's an opinionated set of abstractions and helps data consumers retrieve metric datasets from a data platform quickly and efficiently.
This guide introduces MetricFlow's fundamental ideas for people new to this feature. MetricFlow, which powers the dbt Semantic Layer, helps you define and manage the logic for your company's metrics. It's an opinionated set of abstractions and helps data consumers retrieve metric datasets from a data platform quickly and efficiently.

MetricFlow handles SQL query construction and defines the specification for dbt semantic models and metrics. It allows you to define metrics in your dbt project and query them with [MetricFlow commands](/docs/build/metricflow-commands) whether in dbt Cloud or dbt Core.

Expand Down Expand Up @@ -284,5 +284,4 @@ Yes, but because a dimension is considered an attribute of the primary or unique

## Related docs
- [Joins](/docs/build/join-logic)
- [Validations](/docs/build/validation)

- [Validations](/docs/build/validation)
10 changes: 5 additions & 5 deletions website/docs/docs/build/build-metrics-intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: "Learn about MetricFlow and build your metrics with semantic models
sidebar_label: Build your metrics
tags: [Metrics, Semantic Layer, Governance]
hide_table_of_contents: true
pagination_next: "docs/build/sl-getting-started"
pagination_next: "guides/sl-snowflake-qs"
pagination_prev: null
---

Expand All @@ -20,9 +20,9 @@ MetricFlow allows you to:
<div className="grid--3-col">

<Card
title="Get started with the dbt Semantic Layer and MetricFlow"
body="Use this guide to build and define metrics with MetricFlow, set up the dbt Semantic Layer, and query them using downstream tools."
link="/docs/build/sl-getting-started"
title="Quickstart for the dbt Cloud Semantic Layer"
body="Use this guide to build and define metrics, set up the dbt Semantic Layer, and query them using downstream tools."
link="/guides/sl-snowflake-qs"
icon="dbt-bit"/>

<Card
Expand Down Expand Up @@ -65,7 +65,7 @@ MetricFlow allows you to:

## Related docs

- [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
- [Get started with MetricFlow](/docs/build/sl-getting-started)
- [dbt Semantic Layer on-demand courses](https://courses.getdbt.com/courses/semantic-layer)
- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)
94 changes: 0 additions & 94 deletions website/docs/docs/build/sl-getting-started.md

This file was deleted.

2 changes: 1 addition & 1 deletion website/docs/docs/cloud/billing.md
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@ Customers who purchased the dbt Cloud Team plan before August 11, 2023, remain o

:::note Legacy Semantic Layer

For customers using the legacy Semantic Layer with dbt_metrics package, this product will be deprecated in December 2023. Legacy users may choose to upgrade at any time to the revamped version, Semantic Layer powered by MetricFlow. The revamped version is available to most customers (see [prerequisites](/docs/use-dbt-semantic-layer/quickstart-sl#prerequisites)) for a limited time on a free trial basis, subject to reasonable use.
For customers using the legacy Semantic Layer with dbt_metrics package, this product will be deprecated in December 2023. Legacy users may choose to upgrade at any time to the revamped version, Semantic Layer powered by MetricFlow. The revamped version is available to most customers (see [prerequisites](/guides/sl-snowflake-qs#prerequisites)) for a limited time on a free trial basis, subject to reasonable use.

:::

Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/dbt-cloud-apis/sl-graphql.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ Note that the dbt Semantic Layer API doesn't support `ref` to call dbt objects.

If you're a dbt user or partner with access to dbt Cloud and the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl), you can [setup](/docs/use-dbt-semantic-layer/setup-sl) and test this API with data from your own instance by configuring the Semantic Layer and obtaining the right GQL connection parameters described in this document.

Refer to [Get started with the dbt Semantic Layer](docs/use-dbt-semantic-layer/quickstart-sl) for more info.
Refer to [Get started with the dbt Semantic Layer](/guides/sl-snowflake-qs) for more info.


### Authentication
Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/dbt-cloud-apis/sl-jdbc.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ If you are a dbt user or partner with access to dbt Cloud and the [dbt Semantic

You *may* be able to use our JDBC API with tools that do not have an official integration with the dbt Semantic Layer. If the tool you use allows you to write SQL and either supports a generic JDBC driver option (such as DataGrip) or supports Dremio and uses ArrowFlightSQL driver version 12.0.0 or higher, you can access the Semantic Layer API.

Refer to [Get started with the dbt Semantic Layer](/docs/use-dbt-semantic-layer/quickstart-sl) for more info.
Refer to [Get started with the dbt Semantic Layer](/guides/sl-snowflake-qs) for more info.

Note that the dbt Semantic Layer API doesn't support `ref` to call dbt objects. Instead, use the complete qualified table name. If you're using dbt macros at query time to calculate your metrics, you should move those calculations into your Semantic Layer metric definitions as code.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,6 @@ To experience the universal dbt Semantic Layer and its enhanced beta capabilitie

- [Introducing the new dbt Semantic Layer](https://www.getdbt.com/blog/introducing-new-look-dbt-semantic-layer)
- [dbt Semantic Layer docs](/docs/use-dbt-semantic-layer/dbt-sl)
- [dbt Semantic Layer get started guide](/docs/use-dbt-semantic-layer/quickstart-sl)
- [dbt Semantic Layer get started guide](/guides/sl-snowflake-qs)
- [Build your metrics with MetricFlow](/docs/build/build-metrics-intro)

8 changes: 4 additions & 4 deletions website/docs/docs/use-dbt-semantic-layer/dbt-sl.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: "Learn how the dbt Semantic Layer enables data teams to centrally d
sidebar_label: "About the dbt Semantic Layer"
tags: [Semantic Layer]
hide_table_of_contents: true
pagination_next: "docs/use-dbt-semantic-layer/quickstart-sl"
pagination_next: "guides/sl-snowflake-qs"
pagination_prev: null
---

Expand Down Expand Up @@ -36,9 +36,9 @@ plan="dbt Cloud Team or Enterprise"
<div className="grid--3-col">

<Card
title="Get started with the dbt Semantic Layer and MetricFlow"
body="Build and define metrics with MetricFlow, set up the dbt Semantic Layer, and query them using the Semantic Layer API."
link="/docs/use-dbt-semantic-layer/quickstart-sl"
title="Quickstart with the dbt Cloud Semantic Layer"
body="Build and define metrics, set up the dbt Semantic Layer, and query them using our first-class integrations."
link="/guides/sl-snowflake-qs"
icon="dbt-bit"/>

<Card
Expand Down
100 changes: 0 additions & 100 deletions website/docs/docs/use-dbt-semantic-layer/quickstart-sl.md

This file was deleted.

3 changes: 1 addition & 2 deletions website/docs/docs/use-dbt-semantic-layer/setup-sl.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,6 @@ With the dbt Semantic Layer, you can centrally define business metrics, reduce c

## Prerequisites


import SetUp from '/snippets/_v2-sl-prerequisites.md';

<SetUp/>
Expand Down Expand Up @@ -49,5 +48,5 @@ import SlSetUp from '/snippets/_new-sl-setup.md';
- [Build your metrics](/docs/build/build-metrics-intro)
- [Available integrations](/docs/use-dbt-semantic-layer/avail-sl-integrations)
- [Semantic Layer APIs](/docs/dbt-cloud-apis/sl-api-overview)
- [Get started with the dbt Semantic Layer](/docs/use-dbt-semantic-layer/quickstart-sl)
- [Get started with the dbt Semantic Layer](/guides/sl-snowflake-qs)
- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)
2 changes: 1 addition & 1 deletion website/docs/docs/use-dbt-semantic-layer/sl-faqs.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@ MetricFlow is hosted in dbt Cloud. Requests from the [Semantic Layer APIs](/docs
2. Then you build your metrics on top of these semantic models. This is all done in `.yml` configurations alongside your dbt models in your projects.
3. Once you've defined your metrics and semantic models, you can [configure the dbt Semantic Layer](/docs/use-dbt-semantic-layer/setup-sl) in dbt Cloud.

Read our [Quickstart](/docs/use-dbt-semantic-layer/quickstart-sl) for more information.
Read our [dbt Semantic Layer quickstart](/guides/sl-snowflake-qs) guide for more information.

</expandable>

Expand Down
5 changes: 2 additions & 3 deletions website/docs/guides/sl-migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,12 +133,11 @@ If you created a new environment in [Step 3](#step-3-setup-the-semantic-layer-in

### Related docs

- [Quickstart guide with the dbt Semantic Layer](/guides/sl-snowflake-qs)
- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs)
- [MetricFlow quickstart guide](/docs/build/sl-getting-started)
- [Example dbt project](https://github.com/dbt-labs/jaffle-sl-template)
- [dbt metrics converter](https://github.com/dbt-labs/dbt-converter)
- [Why we're deprecating the dbt_metrics package](/blog/deprecating-dbt-metrics) blog post
- [dbt Semantic Layer API query syntax](/docs/dbt-cloud-apis/sl-jdbc#querying-the-api-for-metric-metadata)
- [dbt Semantic Layer on-demand courses](https://courses.getdbt.com/courses/semantic-layer)

</div>
</div>
Loading
Loading