From f22339f34cabd80a9965d8bae45df22a737deb72 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Thu, 9 May 2024 18:42:17 +0100 Subject: [PATCH 1/9] add loom video this pr adds Jordan's loom video to the new caching doc --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 8 ++++++++ 1 file changed, 8 insertions(+) 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 4327d4673bc..47a40a415da 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -44,6 +44,14 @@ Different data platforms might have different caching layers and cache invalidat Declarative caching enables you to pre-warm the cache using [saved queries](/docs/build/saved-queries) by setting the cache config to `true` in your `saved_queries` settings. This is useful for optimizing performance for key dashboards or common ad-hoc query requests. For configuration details, refer to [Declarative caching setup](#declarative-caching-setup). +
+ +Check out this video demo to see how Declarative caching works + + + +
+ How declarative caching works: - Make sure your saved queries YAML configuration file has [exports](/docs/use-dbt-semantic-layer/exports) defined. - Running a saved query triggers the dbt Semantic Layer to: From 4221fca6c32b09a3fb4089fff48a257c7650314f Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Thu, 9 May 2024 18:44:29 +0100 Subject: [PATCH 2/9] Update website/docs/docs/use-dbt-semantic-layer/sl-cache.md --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 47a40a415da..83744c6cf98 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -48,7 +48,7 @@ Declarative caching enables you to pre-warm the cache using [saved queries](/doc Check out this video demo to see how Declarative caching works - + From 1d7121e8f260f5491e1d10569858fdf1e838c3de Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 9 May 2024 19:01:49 +0100 Subject: [PATCH 3/9] typo --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 83744c6cf98..576d34c606d 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -48,7 +48,7 @@ Declarative caching enables you to pre-warm the cache using [saved queries](/doc Check out this video demo to see how Declarative caching works - + From af9e9fc2a57631a5a904c4e56c867722a8d87812 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 9 May 2024 19:05:24 +0100 Subject: [PATCH 4/9] fix component --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 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 576d34c606d..a58b6dddbd3 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -46,9 +46,11 @@ Declarative caching enables you to pre-warm the cache using [saved queries](/doc
-Check out this video demo to see how Declarative caching works + 📹 Check out this video demo to see how Declarative caching works! - +This video demonstrates the concept of Declarative caching, how to run it using the dbt Cloud scheduler, and how fast your dashboards load as a result. + +
From 18f5e42b1f8e81fd74997a1e20dec9274e00ee41 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Thu, 9 May 2024 19:23:20 +0100 Subject: [PATCH 5/9] Update sl-cache.md explicitly mentions running the cache --- .../docs/docs/use-dbt-semantic-layer/sl-cache.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 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 a58b6dddbd3..9b3bf963b3c 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -64,7 +64,7 @@ How declarative caching works: Refer to the following diagram, which illustrates what happens when the dbt Semantic Layer receives a query request: - + ### Declarative caching setup @@ -99,13 +99,18 @@ saved-queries: ``` -When you run a saved query: +### Run your declarative cache + +After setting up declarative caching in your YAML configuration, you can now run [exports](/docs/use-dbt-semantic-layer/exports) with the dbt Cloud job scheduler to build a cached table from a saved query, into your data platform. + +- Use [exports to set up a job](/docs/use-dbt-semantic-layer/exports) to run a saved query dbt Cloud. - The dbt Semantic Layer builds a cache table in your data platform in a dedicated `dbt_sl_cache` schema. - The cache schema and tables are created using your deployment credentials. You need to grant read access to this schema for your Semantic Layer user. -- Use [exports to set up a job](/docs/use-dbt-semantic-layer/exports) to run a saved query dbt Cloud. - The cache refreshes (or rebuilds) on the same schedule as the saved query job. - + + +After a successful job run, you can go back to your dashboard to experience the speed and benefits of declarative caching. ## Cache management From 7b649e0ae48b5c54c8b79a9f34be8ab35316606e Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Thu, 9 May 2024 19:54:22 +0100 Subject: [PATCH 6/9] Update website/docs/docs/use-dbt-semantic-layer/sl-cache.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 9b3bf963b3c..cf15291252e 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -46,7 +46,7 @@ Declarative caching enables you to pre-warm the cache using [saved queries](/doc
- 📹 Check out this video demo to see how Declarative caching works! + 📹 Check out this video demo to see how declarative caching works! This video demonstrates the concept of Declarative caching, how to run it using the dbt Cloud scheduler, and how fast your dashboards load as a result. From 9727e31c8cac475354335a977499988369b193e8 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Thu, 9 May 2024 19:54:30 +0100 Subject: [PATCH 7/9] Update website/docs/docs/use-dbt-semantic-layer/sl-cache.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 cf15291252e..2014e7287be 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -48,7 +48,7 @@ Declarative caching enables you to pre-warm the cache using [saved queries](/doc 📹 Check out this video demo to see how declarative caching works! -This video demonstrates the concept of Declarative caching, how to run it using the dbt Cloud scheduler, and how fast your dashboards load as a result. +This video demonstrates the concept of declarative caching, how to run it using the dbt Cloud scheduler, and how fast your dashboards load as a result. From 2809033b38b82c8a018bf9ee52af34b44ff8a961 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Thu, 9 May 2024 19:54:37 +0100 Subject: [PATCH 8/9] Update website/docs/docs/use-dbt-semantic-layer/sl-cache.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 2014e7287be..0890a7aec6b 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -101,7 +101,7 @@ saved-queries: ### Run your declarative cache -After setting up declarative caching in your YAML configuration, you can now run [exports](/docs/use-dbt-semantic-layer/exports) with the dbt Cloud job scheduler to build a cached table from a saved query, into your data platform. +After setting up declarative caching in your YAML configuration, you can now run [exports](/docs/use-dbt-semantic-layer/exports) with the dbt Cloud job scheduler to build a cached table from a saved query into your data platform. - Use [exports to set up a job](/docs/use-dbt-semantic-layer/exports) to run a saved query dbt Cloud. - The dbt Semantic Layer builds a cache table in your data platform in a dedicated `dbt_sl_cache` schema. From 1b2ddf9cbe00a909d57e3fc4e1df1f28b091652d Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Thu, 9 May 2024 19:54:50 +0100 Subject: [PATCH 9/9] Update website/docs/docs/use-dbt-semantic-layer/sl-cache.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/docs/use-dbt-semantic-layer/sl-cache.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 0890a7aec6b..5f154ee3d33 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-cache.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-cache.md @@ -64,7 +64,7 @@ How declarative caching works: Refer to the following diagram, which illustrates what happens when the dbt Semantic Layer receives a query request: - + ### Declarative caching setup