Skip to content

Commit

Permalink
SL x snowflake guide (#5242)
Browse files Browse the repository at this point in the history
this pr enhances the existing SL guide by adding more detailed steps for
users. add'l steps mirror existing quickstars and include:
- set up new warehouse
- load data to warehouse
- create cloud acct
- build project
- create semantic models
-define metrics.
...etc.

this is in collaboration with the training team. [notion draft
here](https://www.notion.so/dbtlabs/First-draft-5f46cc9d2ba14e17bec87fb4d7416112)
and [notion
project](https://www.notion.so/dbtlabs/dbt-SL-quickstart-refresh-zero-to-hero-workshop-583f3c8f8e7a4238802e5ac4cbc4712d?pvs=4)
  • Loading branch information
mirnawong1 authored Apr 19, 2024
2 parents 532141f + c444f6b commit c85f166
Show file tree
Hide file tree
Showing 22 changed files with 1,014 additions and 287 deletions.
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

0 comments on commit c85f166

Please sign in to comment.