dbt-labs · mirnawong1 · Aug 3, 2023 · Jul 17, 2023 · Jul 17, 2023 · Jul 17, 2023
@@ -183,6 +183,22 @@ exports.versionedPages = [
     "page": "docs/build/ratio",
     "firstVersion": "1.6",
   },
+  {
+    "category": "docs/use-dbt-semantic-layer/sl-api-overview",
+    "firstVersion": "1.6",
+  },
+	{
+    "category": "docs/use-dbt-semantic-layer/graphql",
+    "firstVersion": "1.6",
+  },
+	{
+    "category": "docs/use-dbt-semantic-layer/jdbc",
+    "firstVersion": "1.6",
+  },
+  {
+    "category": "docs/use-dbt-semantic-layer/sl-manifest",
+    "firstVersion": "1.6",
+  },
 ]
 
 exports.versionedCategories = [
@@ -193,5 +209,9 @@ exports.versionedCategories = [
   {
     "category": "Build your metrics",
     "firstVersion": "1.6",
+  },
+  {
+    "category": "Semantic Layer APIs",
+    "firstVersion": "1.6",
   }
 ]
@@ -10,7 +10,7 @@ This guide introduces MetricFlow's fundamental ideas for new users. MetricFlow,
 
 :::info
 
-MetricFlow is a new way to define metrics in dbt and one of the key components of the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-semantic-layer). It handles SQL query construction and defines the specification for dbt semantic models and metrics. 
+MetricFlow is a new way to define metrics in dbt and one of the key components of the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl). It handles SQL query construction and defines the specification for dbt semantic models and metrics. 
 
 To fully experience the dbt Semantic Layer, including the ability to query dbt metrics via external integrations, you'll need a [dbt Cloud Team or Enterprise account](https://www.getdbt.com/pricing/).
 

@@ -7,7 +7,7 @@ tags: [Metrics, Semantic Layer, Governance]
 hide_table_of_contents: true
 ---
 
-Use MetricFlow in dbt to centrally define your metrics. MetricFlow is a key component of the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-semantic-layer) and is responsible for SQL query construction and defining specifications for dbt semantic models and metrics.
+Use MetricFlow in dbt to centrally define your metrics. MetricFlow is a key component of the [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) and is responsible for SQL query construction and defining specifications for dbt semantic models and metrics.
 
 Use familiar constructs like semantic models and metrics to avoid duplicative coding, optimize your development workflow, ensure data governance for company metrics, and guarantee consistency for data consumers.
 
@@ -25,31 +25,44 @@ Before you start, keep the following considerations in mind:
   * Note: Support for BigQuery, Databricks, and Redshift coming soon.
 - dbt Labs is working with [integration partners](https://www.getdbt.com/product/semantic-layer-integrations) to develop updated integrations for the new Semantic Layer, powered by MetricFlow, in addition to introducing other consumption methods like Python and JDBC. <br /><br />
 
-<div className="grid--4-col">
+<div className="grid--3-col">
 
 <Card
     title="About MetricFlow"
     body="Understand MetricFlow's core concepts, key principles, and how to use this powerful tool."
     link="/docs/build/about-metricflow"
-    icon="rocket"/>
-
-<Card
-    title="Get started with MetricFlow"
-    body="Learn how to create a semantic model, a metric, and test and upload your metric using MetricFlow."
-    link="/docs/build/sl-getting-started"
-    icon="rocket"/>
+    icon="dbt-bit"/>
 
   <Card
     title="Semantic model"
-    body="Use Semantic models as the basis for defining data. They act as nodes in the semantic graph, with entities connecting them."
+    body="Use semantic models as the basis for defining data. They act as nodes in the semantic graph, with entities connecting them."
     link="/docs/build/semantic-models"
-    icon="rocket"/>
+    icon="dbt-bit"/>
 
   <Card
     title="Metrics"
     body="Define metrics through the powerful combination of measures, constraints, or functions, effortlessly organized in either YAML files or separate files."
     link="/docs/build/metrics-overview"
-    icon="rocket"/>   
+    icon="dbt-bit"/>
+
+  <Card
+    title="About the dbt Semantic Layer"
+    body="Introducing the dbt Semantic Layer, the universal process that allows data teams to centrally define and query metrics"
+    link="/docs/use-dbt-semantic-layer/dbt-sl"
+    icon="dbt-bit"/>
+
+ <Card
+    title="Get started with the dbt Semantic Layer"
+    body="Use this guide to build and define metrics, set up the dbt Semantic Layer, and query them using the Semantic Layer APIs"
+    link="/docs/use-dbt-semantic-layer/quickstart-sl"
+    icon="dbt-bit"/>
+
+  <Card
+    title="Available integrations"
+    body="Discover the diverse range of partners that seamlessly integrate with the powerful dbt Semantic Layer, allowing you to query and unlock valuable insights from your data ecosystem."
+    link="/docs/use-dbt-semantic-layer/avail-sl-integrations"
+    icon="dbt-bit"/>
+
 
 </div> <br />
 

@@ -6,23 +6,9 @@ keywords:
   - dbt metrics layer
 ---
 
-<VersionBlock firstVersion="1.6">
-
-:::info dbt Metrics isn't supported
-
-dbt Metrics is no longer supported in v1.6 and higher. To build your semantic layer, define and query metrics, and provide data governance - refer to [Build your Semantic Layer](/docs/build/build-metrics-intro) for updated guidance.
-
-:::
-</VersionBlock>
-
-<VersionBlock lastVersion="1.5">
-
-:::info dbt Metrics not recommended
-
-dbt Metrics won't be supported in v1.6 and higher, and is being replaced with MetricFlow. [Defining metrics](/docs/build/build-semantic-layer-intro) with MetricFlow will help shape the future of the dbt Semantic Layer &mdash; let us know [your thoughts and join the convo](https://github.com/dbt-labs/dbt-core/discussions/7456) to help build it!
-
-:::
+import LegacyInfo from '/snippets/_legacy-sl-callout.md';
 
+<LegacyInfo />
 
 <Changelog>
 
@@ -31,6 +17,7 @@ dbt Metrics won't be supported in v1.6 and higher, and is being replaced with Me
 
 </Changelog>
 
+<VersionBlock lastVersion="1.5">
 
 A metric is an aggregation over a <Term id="table" /> that supports zero or more dimensions. Some examples of metrics include:
 - active users
@@ -218,9 +205,12 @@ Metrics can have many declared **properties**, which define aspects of your metr
 ### Available calculation methods
 
 <VersionBlock firstVersion="1.3">
+
 The method of calculation (aggregation or derived) that is applied to the expression.
 </VersionBlock> 
+
 <VersionBlock lastVersion="1.2">
+
 The type of calculation (aggregation or expression) that is applied to the sql property.
 </VersionBlock> 
 
@@ -541,6 +531,7 @@ The period to date secondary calculation performs an aggregation on a defined pe
 #### Rolling:
 
 <VersionBlock firstVersion="1.3" >
+
 The rolling secondary calculation performs an aggregation on a number of rows in metric dataset. For example, if the user selects the `week` grain and sets a rolling secondary calculation to `4` then the value returned will be a rolling 4 week calculation of whatever aggregation type was selected. If the `interval` input is not provided then the rolling caclulation will be unbounded on all preceding rows.
 
 | Input                      | Example | Description | Required |
@@ -552,6 +543,7 @@ The rolling secondary calculation performs an aggregation on a number of rows in
 </VersionBlock>
 
 <VersionBlock lastVersion="1.2" >
+
 The rolling secondary calculation performs an aggregation on a number of rows in the metric dataset. For example, if the user selects the `week` grain and sets a rolling secondary calculation to `4`, then the value returned will be a rolling 4-week calculation of whatever aggregation type was selected.
 
 | Input                      | Example | Description | Required |
@@ -715,4 +707,6 @@ The above example will return a dataset that contains the metric provided in the
 </VersionBlock>
 
 <Snippet path="discourse-help-feed-header" />
+
 <DiscourseHelpFeed tags="metrics"/>
+
@@ -126,6 +126,7 @@ ANY COMMON TROUBLESHOOTING QUESTIONS?-->
 
 ## Related docs
 
+- [Get started with the dbt Semantic Layer](/docs/use-dbt-semantic-layer/quickstart-sl)
 - [The dbt Semantic Layer: what’s next](https://www.getdbt.com/blog/dbt-semantic-layer-whats-next/) blog post
 - [About MetricFlow](/docs/build/about-metricflow)
 - [Semantic models](/docs/build/semantic-models)

@@ -63,7 +63,7 @@ link="/docs/cloud/dbt-cloud-ide/develop-in-the-cloud"
    <Card
     title="dbt Semantic Layer*"
     body="Use the dbt Semantic Layer to define metrics alongside your dbt models and query them from any integrated analytics tool. Get the same answers everywhere, every time."
-    link="/docs/use-dbt-semantic-layer/dbt-semantic-layer"
+    link="/docs/use-dbt-semantic-layer/dbt-sl"
     icon="pencil-paper"/>  
 
    <Card

@@ -8,10 +8,11 @@ id: "overview"
 
 Accounts on the _Team_ and _Enterprise_ plans can query the dbt Cloud APIs.
 
-dbt Cloud provides two APIs:
+dbt Cloud provides the following APIs:
 
 - The [dbt Cloud Administrative API](/docs/dbt-cloud-apis/admin-cloud-api) can be used to administrate a dbt Cloud account.
 - The [dbt Cloud Discovery API](/docs/dbt-cloud-apis/discovery-api) can be used to fetch metadata related to the state and health of your dbt project.
+- The [dbt Semantic Layer API](/docs/use-dbt-semantic-layer/sl-api-overview) provides multiple API options which allow you to query your metrics defined in the dbt Semantic Layer.
 
 If you want to learn more about webhooks, refer to [Webhooks for your jobs](/docs/deploy/webhooks).
 

@@ -0,0 +1,55 @@
+---
+title: "Semantic Layer APIs"
+id: sl-api-overview
+description: "Integrate and query using the Semantic Layer API."
+tags: ["semantic-layer, apis"]
+hide_table_of_contents: true
+---
+
+<VersionBlock lastVersion="1.5">
+
+import UpgradeSL from '/snippets/_upgrade-new-sl.md';
+
+<UpgradeSL />
+
+</VersionBlock>
+
+The rapid growth of different tools in the modern data stack has helped data professionals address the diverse needs of different teams. The downside of this growth is the fragmentation of business logic across teams, tools, and workloads.
+
+The [dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl) allows users to define metrics in code (with [MetricFlow](/docs/build/about-metricflow)) and dynamically generate and query datasets in downstream tools based on their dbt governed assets, such as metrics and models. Integrating with the dbt Semantic Layer will help the organizations that uses your product make more efficient and trustworthy decisions with their data. It also helps avoid duplicative coding, optimizes development workflow, ensures data governance, and guarantee consistency for data consumers.  
+
+You can use the dbt Semantic Layer for a variety of tools and applications of data. Here are some common use cases:
+
+* Business intelligence (BI), reporting, and analytics
+* Data quality and monitoring
+* Governance and privacy
+* Data discovery and cataloging
+* Machine learning and data science
+
+The dbt Semantic Layer APIs are available for accounts on [Team or Enterprise plans](https://www.getdbt.com/pricing/), allowing them to query metrics and build integrations. Users on dbt Cloud Developer plans or dbt Core users can use MetricFlow to only define and test metrics locally. 
+
+<div className="grid--3-col">
+
+<Card
+    title="JDBC API"
+    body="Use a JDBC driver to query metrics in downstream tools."
+    link="/docs/dbt-cloud-apis/sl-jdbc"
+    icon="dbt-bit"/>
+
+<Card
+    title="GraphQL API"
+    body="Use GraphQL to query metrics in downstream tools."
+    link="/docs/dbt-cloud-apis/sl-graphql"
+    icon="dbt-bit"/>
+
+<Card
+    title="Semantic manifest"
+    body="Learn about the semantic manifest.json file and how you can use artifacts to gain insights about your Semantic Layer."
+    link="/docs/dbt-cloud-apis/sl-manifest"
+    icon="dbt-bit"/>
+
+</div>
+
+## Authentication
+
+dbt Cloud authorizes requests to the dbt Semantic Layer APIs. You need to provide an environment ID, host, and [service account tokens](/docs/dbt-cloud-apis/service-tokens).
@@ -0,0 +1,92 @@
+---
+title: "GraphQL"
+id: sl-graphql
+description: "Integrate and use the GraphQL API to query your metrics."
+tags: ["semantic-layer, apis"]
+---
+
+<VersionBlock lastVersion="1.5">
+
+import UpgradeSL from '/snippets/_upgrade-new-sl.md';
+
+<UpgradeSL />
+
+</VersionBlock>
+
+
+
+
+GraphQL is an open-source query language for APIs (Application Programming Interfaces). It provides a more efficient and flexible alternative to traditional RESTful APIs. 
+
+With GraphQL, clients can request specific data requirements using a single query. GraphQL allows clients to retrieve all the needed data in a single request. This reduces the number of round trips to the server, minimizing network overhead and improving performance.
+
+Overall, GraphQL offers benefits such as being self-documenting, a strong typing system, versioning and evolution support, enabling rapid development, and a robust ecosystem. These advantages make GraphQL a powerful choice for building APIs that prioritize flexibility, performance, and developer productivity.
+
+
+### dbt Semantic Layer GraphQL API
+
+The dbt Semantic Layer GraphQL API has the following capabilities and has similarities to the calls available in our JDBC API.
+
+One benefit of GraphQL is its self documenting nature, so you can explore using our schema explorer(todolink). To give you an idea of the types of commands you can execute, we provide some available calls below.
+
+
+**Metric Metadata Calls**
+
+Fetch available metrics
+```graphql
+metrics(environmentId: Int!): [Metric!]!
+```
+
+Fetch available dimensions for metrics
+
+```graphql
+dimensions(
+environmentId: Int!
+metrics: [String!]!
+): [Dimension!]!
+```
+
+Fetch available time granularities given metrics
+
+```graphql
+queryableGranularities(
+environmentId: Int!
+metrics: [String!]!
+): [TimeGranularity!]!
+```
+
+Fetch available metrics given a set of a dimensions
+
+```graphql
+metricsForDimensions(
+environmentId: Int!
+dimensions: [String!]!
+): [Metric!]!
+```
+
+Fetch dimension values for metrics and a given dimension
+
+```graphql
+dimensionValues(
+environmentId: Int!
+metrics: [String!]!
+dimension: String!
+```
+
+**Metric Value Query Parameters**
+
+The mutation is `createQuery`. The parameters are as follows:
+
+```graphql
+createQuery(
+environmentId: Int!
+metrics: [String!]!
+dimensions: [String!] = null
+limit: Int = null
+startTime: String = null
+endTime: String = null
+where: String = null
+order: [String!] = null
+): String
+```
+