Skip to content

Commit

Permalink
deprecated content
Browse files Browse the repository at this point in the history
  • Loading branch information
@mirnawong1
mirnawong1 committed Dec 6, 2023
1 parent 524d335 commit 573b65e
Show file tree
Hide file tree
Showing 9 changed files with 6 additions and 1,122 deletions.
696 changes: 0 additions & 696 deletions website/docs/docs/build/metrics.md
View file

This file was deleted.

2 changes: 1 addition & 1 deletion website/docs/docs/build/projects.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ At a minimum, all a project needs is the `dbt_project.yml` project configuration
| [docs](/docs/collaborate/documentation) | Docs for your project that you can build. |
| [sources](/docs/build/sources) | A way to name and describe the data loaded into your warehouse by your Extract and Load tools. |
| [exposures](/docs/build/exposures) | A way to define and describe a downstream use of your project. |
| [metrics](/docs/build/metrics) | A way for you to define metrics for your project. |
| [metrics](/docs/build/build-metrics-intro) | A way for you to define metrics for your project. |
| [groups](/docs/build/groups) | Groups enable collaborative node organization in restricted collections. |
| [analysis](/docs/build/analyses) | A way to organize analytical SQL queries in your project such as the general ledger from your QuickBooks. |

Expand Down
25 changes: 0 additions & 25 deletions website/docs/docs/use-dbt-semantic-layer/avail-sl-integrations.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,6 @@ meta:
api_name: dbt Semantic Layer APIs
---

<VersionBlock firstVersion="1.6">


There are a number of data applications that seamlessly integrate with the dbt Semantic Layer, powered by MetricFlow, from business intelligence tools to notebooks, spreadsheets, data catalogs, and more. These integrations allow you to query and unlock valuable insights from your data ecosystem.

Use the [dbt Semantic Layer APIs](/docs/dbt-cloud-apis/sl-api-overview) to simplify metric queries, optimize your development workflow, and reduce coding. This approach also ensures data governance and consistency for data consumers.
Expand All @@ -34,25 +31,3 @@ import AvailIntegrations from '/snippets/_sl-partner-links.md';
- [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.

</VersionBlock>

<VersionBlock lastVersion="1.5">

import DeprecationNotice from '/snippets/_sl-deprecation-notice.md';

<DeprecationNotice />

A wide variety of data applications across the modern data stack natively integrate with the dbt Semantic Layer and dbt metrics &mdash; from Business Intelligence tools to notebooks, data catalogs, and more.

The dbt Semantic Layer integrations are capable of querying dbt metrics, importing definitions, surfacing the underlying data in partner tools, and leveraging the dbt Server.

For information on the partner integrations, their documentation, and more &mdash; refer to the [dbt Semantic Layer integrations](https://www.getdbt.com/product/semantic-layer-integrations) page.

<Lightbox src="/img/docs/dbt-cloud/semantic-layer/sl_architecture.png" width="75%" title="The universal dbt Semantic Layer connecting to integration tools."/>

## Related docs

- [About the dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl)

</VersionBlock>
99 changes: 0 additions & 99 deletions website/docs/docs/use-dbt-semantic-layer/dbt-sl.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,6 @@ pagination_next: "docs/use-dbt-semantic-layer/quickstart-sl"
pagination_prev: null
---

<VersionBlock firstVersion="1.6">



The dbt Semantic Layer, powered by [MetricFlow](/docs/build/about-metricflow), simplifies the process of defining and using critical business metrics, like `revenue` in the modeling layer (your dbt project). By centralizing metric definitions, data teams can ensure consistent self-service access to these metrics in downstream data tools and applications. The dbt Semantic Layer eliminates duplicate coding by allowing data teams to define metrics on top of existing models and automatically handles data joins.

Expand Down Expand Up @@ -62,99 +59,3 @@ plan="dbt Cloud Team or Enterprise"
icon="dbt-bit"/>

</div>

</VersionBlock>

<VersionBlock lastVersion="1.5">

import DeprecationNotice from '/snippets/_sl-deprecation-notice.md';

<DeprecationNotice />

The dbt Semantic Layer allows your data teams to centrally define essential business metrics like `revenue`, `customer`, and `churn` in the modeling layer (your dbt project) for consistent self-service within downstream data tools like BI and metadata management solutions. The dbt Semantic Layer provides the flexibility to define metrics on top of your existing models and then query those metrics and models in your analysis tools of choice.

Resulting in less duplicate coding for data teams and more consistency for data consumers.

The dbt Semantic Layer has these main parts:

- Define your metrics in version-controlled dbt project code using [MetricFlow](/docs/build/about-metricflow)
* dbt_metrics is now deprecated
- Import your metric definitions using the [Discovery API](/docs/dbt-cloud-apis/discovery-api)
- Query your metric data with the dbt Proxy Server
- Explore and analyze dbt metrics in downstream tools

### What makes the dbt Semantic Layer different?

The dbt Semantic Layer reduces code duplication and inconsistency regarding your business metrics. By moving metric definitions out of the BI layer and into the modeling layer, your data teams can 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. You can also use the dbt Semantic Layer to query models and use macros.


## Prerequisites

<Snippet path="sl-prerequisites" />

<Snippet path="sl-considerations-banner" />


## Manage metrics

:::info 📌

New to dbt or metrics? Check out our [quickstart guide](/guides) to build your first dbt project! If you'd like to define your first metrics, try our [Jaffle Shop](https://github.com/dbt-labs/jaffle_shop_metrics) example project.

:::

If you're not sure whether to define a metric in dbt or not, ask yourself the following:

> *Is this something our teams consistently need to report on?*
An important business metric should be:

- Well-defined (the definition is agreed upon throughout the entire organization)
- Time-bound (able to be compared across time)

A great example of this is **revenue**. It can be aggregated on multiple levels (weekly, monthly, and so on) and is key for the broader business to understand.

- ✅ `Monthly recurring revenue` or `Weekly active users` or `Average order value`
- ❌ `1-off experimental metric`


### Design and define metrics

You can design and define your metrics in `.yml` files nested under a metrics key in your dbt project. For more information, refer to these docs: <br />

- [dbt metrics](docs/build/metrics) for in-depth detail on attributes, filters, how to define and query your metrics, and [dbt-metrics package](https://github.com/dbt-labs/dbt_metrics)
- [dbt Semantic Layer quickstart](/docs/use-dbt-semantic-layer/quickstart-semantic-layer) to get started

## Related questions

<details>
<summary>How do I migrate from the legacy Semantic Layer to the new one?</summary>
<div>
<div>If you're using the legacy Semantic Layer, we highly recommend you <a href="https://docs.getdbt.com/docs/dbt-versions/upgrade-core-in-cloud">upgrade your dbt version </a> to dbt v1.6 or higher to use the new dbt Semantic Layer. Refer to the dedicated <a href="https://docs.getdbt.com/guides/sl-migration"> migration guide</a> for more info.</div>
</div>
</details>

<details>
<summary>How are you storing my data?</summary>
<div>
<div>The dbt Semantic Layer doesn't store, cache, or log your data. On each query to the Semantic Layer, the resulting data passes through dbt Cloud servers where it's never stored, cached, or logged. The data from your data platform gets routed through dbt Cloud servers to your connecting data tool.</div>
</div>
</details>
<details>
<summary>Is the dbt Semantic Layer open source?</summary>
<div>
<div>Some components of the dbt Semantic Layer are open source like dbt-core, the dbt_metrics package, and the BSL-licensed dbt-server. The dbt Proxy Server (what is actually compiling the dbt code) and the Discovery API are not open source. <br></br><br></br>
During Public Preview, the dbt Semantic Layer is open to all dbt Cloud tiers &mdash; Developer, Team, and Enterprise.<br></br><br></br>

</div> </div>
</details>
<details>
<summary>Is there a dbt Semantic Layer discussion hub?</summary>
<div>
<div>Yes, absolutely! Join the <a href="https://getdbt.slack.com">dbt Slack community</a> and <a href="https://getdbt.slack.com/archives/C046L0VTVR6">#dbt-cloud-semantic-layer slack channel</a> for all things related to the dbt Semantic Layer.
</div>
</div>
</details>
<br></br>
</VersionBlock>
Loading

0 comments on commit 573b65e

Please sign in to comment.