From e3023f8eefa84d06b82d60a9c70eff7eb8de4cdd Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 26 Apr 2024 15:55:25 +0100 Subject: [PATCH 1/7] add add'l faq to SL adds data storing faq per user feedback/question raised [internal slack](https://dbt-labs.slack.com/archives/C043J5F7NUX/p1714096405051509) --- website/docs/docs/use-dbt-semantic-layer/sl-faqs.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md index e9e33356aa2..f70b9312c8c 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md @@ -124,6 +124,18 @@ The dbt Semantic Layer dynamically computes the metric using the underlying data The dbt Semantic Layer does not store a physical copy of your data. It uses underlying tables to construct or compute the requested output. + + +The dbt Semantic Layer is part of dbt Cloud. It allows data teams to define metrics once, centrally, and access them from any integrated analytics tool, ensuring consistent answers across diverse datasets. In providing this service, dbt Labs permits clients to access Semantic Layer metrics. Client data passes through the Semantic Layer on the way back from the data warehouse. + +dbt Labs handles this in a secure way using encryption and authentication from the client’s data warehouse. In certain cases, such data may be cached on dbt Labs system ephemerally (potentially for up to 10 minutes although usually much shorter time frame). + +dbt Labs employees cannot access cached data during normal business operations and must have direct manager approval for access to the underlying infrastructure. Approval for such access would only be granted when necessary for providing a client services and never with the purpose of enriching dbt Labs. No client warehouse data is retained on dbt Labs's systems. + +In the coming months, we are releasing a longer-term caching solution to optimize query performance. This caching feature will make use of the client data warehouse, and such cached data will not be stored on dbt Labs’s systems. In addition, this feature will be activated only through an opt-in. Therefore caching is always in client hands and at client discretion. + + + MetricFlow is hosted in dbt Cloud. Requests from the [Semantic Layer APIs](/docs/dbt-cloud-apis/sl-api-overview) are routed from our API gateway to MetricFlow, which generates the SQL to compute what's requested by the user. MetricFlow hands the SQL back to our gateway, which then executes it against the data platform. From 563c7df4d395fba94c48f38f65d8a39346320159 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 26 Apr 2024 16:03:04 +0100 Subject: [PATCH 2/7] Update website/docs/docs/use-dbt-semantic-layer/sl-faqs.md --- website/docs/docs/use-dbt-semantic-layer/sl-faqs.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md index f70b9312c8c..b01789bac7e 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md @@ -126,7 +126,9 @@ The dbt Semantic Layer does not store a physical copy of your data. It uses unde -The dbt Semantic Layer is part of dbt Cloud. It allows data teams to define metrics once, centrally, and access them from any integrated analytics tool, ensuring consistent answers across diverse datasets. In providing this service, dbt Labs permits clients to access Semantic Layer metrics. Client data passes through the Semantic Layer on the way back from the data warehouse. +The dbt Semantic Layer is part of dbt Cloud. Terms of Service (ToS) for dbt Cloud apply to the Semantic Layer as well. + +The dbt Semantic Layer allows data teams to define metrics once, centrally, and access them from any integrated analytics tool, ensuring consistent answers across diverse datasets. In providing this service, dbt Labs permits clients to access Semantic Layer metrics. Client data passes through the Semantic Layer on the way back from the data warehouse. dbt Labs handles this in a secure way using encryption and authentication from the client’s data warehouse. In certain cases, such data may be cached on dbt Labs system ephemerally (potentially for up to 10 minutes although usually much shorter time frame). From 4b89fc3c5446cbe91adefc7906049c00c04d723d Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 26 Apr 2024 16:10:02 +0100 Subject: [PATCH 3/7] Update website/docs/docs/use-dbt-semantic-layer/sl-faqs.md --- website/docs/docs/use-dbt-semantic-layer/sl-faqs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md index b01789bac7e..99967143785 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md @@ -126,7 +126,7 @@ The dbt Semantic Layer does not store a physical copy of your data. It uses unde -The dbt Semantic Layer is part of dbt Cloud. Terms of Service (ToS) for dbt Cloud apply to the Semantic Layer as well. +The dbt Semantic Layer is part of dbt Cloud. The dbt Semantic Layer allows data teams to define metrics once, centrally, and access them from any integrated analytics tool, ensuring consistent answers across diverse datasets. In providing this service, dbt Labs permits clients to access Semantic Layer metrics. Client data passes through the Semantic Layer on the way back from the data warehouse. From 235006f31900f0ef82b240eb3bed830346964a09 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 26 Apr 2024 16:11:37 +0100 Subject: [PATCH 4/7] Update sl-faqs.md --- website/docs/docs/use-dbt-semantic-layer/sl-faqs.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md index 99967143785..cfd392be0f3 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md @@ -126,9 +126,7 @@ The dbt Semantic Layer does not store a physical copy of your data. It uses unde -The dbt Semantic Layer is part of dbt Cloud. - -The dbt Semantic Layer allows data teams to define metrics once, centrally, and access them from any integrated analytics tool, ensuring consistent answers across diverse datasets. In providing this service, dbt Labs permits clients to access Semantic Layer metrics. Client data passes through the Semantic Layer on the way back from the data warehouse. +The dbt Semantic Layer is part of dbt Cloud. It allows data teams to define metrics once, centrally, and access them from any integrated analytics tool, ensuring consistent answers across diverse datasets. In providing this service, dbt Labs permits clients to access Semantic Layer metrics. Client data passes through the Semantic Layer on the way back from the data warehouse. dbt Labs handles this in a secure way using encryption and authentication from the client’s data warehouse. In certain cases, such data may be cached on dbt Labs system ephemerally (potentially for up to 10 minutes although usually much shorter time frame). @@ -138,6 +136,13 @@ In the coming months, we are releasing a longer-term caching solution to optimiz + + +Yes it does. + + + + MetricFlow is hosted in dbt Cloud. Requests from the [Semantic Layer APIs](/docs/dbt-cloud-apis/sl-api-overview) are routed from our API gateway to MetricFlow, which generates the SQL to compute what's requested by the user. MetricFlow hands the SQL back to our gateway, which then executes it against the data platform. From fde60a83f9cf529185bc1db8d5895ba0de9ef959 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 10 May 2024 16:13:18 +0100 Subject: [PATCH 5/7] Update sl-faqs.md adding brenda's legal content --- website/docs/docs/use-dbt-semantic-layer/sl-faqs.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md index cfd392be0f3..a07424b5d87 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md @@ -130,9 +130,9 @@ The dbt Semantic Layer is part of dbt Cloud. It allows data teams to define metr dbt Labs handles this in a secure way using encryption and authentication from the client’s data warehouse. In certain cases, such data may be cached on dbt Labs system ephemerally (potentially for up to 10 minutes although usually much shorter time frame). -dbt Labs employees cannot access cached data during normal business operations and must have direct manager approval for access to the underlying infrastructure. Approval for such access would only be granted when necessary for providing a client services and never with the purpose of enriching dbt Labs. No client warehouse data is retained on dbt Labs's systems. +dbt Labs employees cannot access cached data during normal business operations and must have direct manager approval for access to the underlying infrastructure. Approval for such access would only be granted when necessary for providing a client services and never with the purpose of enriching dbt Labs. -In the coming months, we are releasing a longer-term caching solution to optimize query performance. This caching feature will make use of the client data warehouse, and such cached data will not be stored on dbt Labs’s systems. In addition, this feature will be activated only through an opt-in. Therefore caching is always in client hands and at client discretion. +No client warehouse data is retained on dbt Labs's systems. We offer a caching solution to optimize query performance. This caching feature makes use of the client data warehouse, and such cached data is not stored on dbt Labs’s systems. In addition, this feature is activated only through a client opt-in. Therefore caching is always in client hands and at client discretion. @@ -231,7 +231,7 @@ Yes, while [entities](/docs/build/entities) must be defined under “entities, -There are a number of data applications have integrations with the dbt Semantic Layer, including Tableau, Google Sheets, Hex, and Mode, among others. +There are a number of data applications that have integrations with the dbt Semantic Layer, including Tableau, Google Sheets, Hex, and Mode, among others. Refer to [Available integrations](/docs/use-dbt-semantic-layer/avail-sl-integrations) for more information. From f5a6e8747dd25c26c2211627b057152bbdb70c5f Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 10 May 2024 16:15:39 +0100 Subject: [PATCH 6/7] Update sl-cache.md add link to faqs --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md index 5f154ee3d33..91da24d9e2c 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -120,9 +120,6 @@ If an upstream model has data in it that was created after the cache was created You can manually invalidate the cache through the [dbt Semantic Layer APIs](/docs/dbt-cloud-apis/sl-api-overview) using the `InvalidateCacheResult` field. -## FAQs - - -Your data remains within your own data platform. This ensures privacy as dbt Cloud uses this existing infrastructure for caching - - +## Related docs +- [Saved queries](/docs/build/saved-queries) +- [dbt Semantic Layer FAQs](/docs/use-dbt-semantic-layer/sl-faqs) From 88fb1ef14d1dff52a0f177ba6a540a9c6888ae5c Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 10 May 2024 16:58:55 +0100 Subject: [PATCH 7/7] Update sl-faqs.md update content --- website/docs/docs/use-dbt-semantic-layer/sl-faqs.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md index a07424b5d87..79825084709 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-faqs.md @@ -128,11 +128,11 @@ The dbt Semantic Layer does not store a physical copy of your data. It uses unde The dbt Semantic Layer is part of dbt Cloud. It allows data teams to define metrics once, centrally, and access them from any integrated analytics tool, ensuring consistent answers across diverse datasets. In providing this service, dbt Labs permits clients to access Semantic Layer metrics. Client data passes through the Semantic Layer on the way back from the data warehouse. -dbt Labs handles this in a secure way using encryption and authentication from the client’s data warehouse. In certain cases, such data may be cached on dbt Labs system ephemerally (potentially for up to 10 minutes although usually much shorter time frame). +dbt Labs handles this in a secure way using encryption and authentication from the client’s data warehouse. In certain cases, such data may be cached on dbt Labs system ephemerally (data is not persistently stored). -dbt Labs employees cannot access cached data during normal business operations and must have direct manager approval for access to the underlying infrastructure. Approval for such access would only be granted when necessary for providing a client services and never with the purpose of enriching dbt Labs. +dbt Labs employees cannot access cached data during normal business operations and must have a business need and/or direct manager approval for access to the underlying infrastructure. Access would only be when necessary for providing a client services and never with the purpose of enriching dbt Labs. -No client warehouse data is retained on dbt Labs's systems. We offer a caching solution to optimize query performance. This caching feature makes use of the client data warehouse, and such cached data is not stored on dbt Labs’s systems. In addition, this feature is activated only through a client opt-in. Therefore caching is always in client hands and at client discretion. +No client warehouse data is retained on dbt Labs's systems. We offer a caching solution to optimize query performance. The caching feature uses client data warehouse storage rather than being stored on dbt Labs’s systems. In addition, this feature is activated only through a client opt-in. Therefore, caching is always in client hands and at client discretion