Skip to content

Commit 68ce827

Browse files
authored
docs: add banners for Cube + Snowflake event (#6929)
1 parent 9b14fd3 commit 68ce827

File tree

15 files changed

+133
-29
lines changed

15 files changed

+133
-29
lines changed

docs/content/Configuration/Databases/Snowflake.mdx

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,13 @@ title: Snowflake
33
permalink: /config/databases/snowflake
44
---
55

6+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
7+
8+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake) on Getting Started with Cube Cloud and Snowflake.
9+
Learn how to easily connect Cube Cloud and Snowflake, load your data, and integrate your BI tools.
10+
11+
</InfoBox>
12+
613
## Prerequisites
714

815
- [The account ID][snowflake-docs-account-id] for [Snowflake][snowflake]

docs/content/Getting-Started/Cloud/01-Overview.mdx

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,13 @@ subCategory: Cube Cloud
66
menuOrder: 2
77
---
88

9+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
10+
11+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake) on Getting Started with Cube Cloud and Snowflake.
12+
Learn how to easily connect Cube Cloud and Snowflake, load your data, and integrate your BI tools.
13+
14+
</InfoBox>
15+
916
This getting started guide will show you how to use Cube Cloud with Snowflake. You will learn how to:
1017

1118
- Load sample data into your Snowflake account

docs/content/Getting-Started/Cloud/02-Load data.mdx

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,13 @@ subCategory: Cube Cloud
66
menuOrder: 2.1
77
---
88

9+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
10+
11+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake) on Getting Started with Cube Cloud and Snowflake.
12+
Learn how to easily connect Cube Cloud and Snowflake, load your data, and integrate your BI tools.
13+
14+
</InfoBox>
15+
916
The following steps will guide you through setting up a Snowflake account and uploading the demo dataset, which is stored as CSV files in a public S3 bucket.
1017

1118
First, let’s create a warehouse, database, and schema. Paste the following SQL into the Editor of the Snowflake worksheet and click Run.
@@ -105,4 +112,4 @@ Run the following command to load data into the `products` table.
105112
COPY INTO cube_demo.ecom.products (id, name, created_at, product_category)
106113
FROM 's3://cube-tutorial/products.csv'
107114
FILE_FORMAT = (TYPE = 'CSV' FIELD_DELIMITER = ',' SKIP_HEADER = 1);
108-
```
115+
```

docs/content/Getting-Started/Cloud/03-Connect-to-Snowflake.mdx

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,14 @@ subCategory: Cube Cloud
66
menuOrder: 3
77
---
88

9-
In this section, we’ll create a Cube Cloud deployment and connect it to Snowflake.
9+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
10+
11+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake) on Getting Started with Cube Cloud and Snowflake.
12+
Learn how to easily connect Cube Cloud and Snowflake, load your data, and integrate your BI tools.
13+
14+
</InfoBox>
15+
16+
In this section, we’ll create a Cube Cloud deployment and connect it to Snowflake.
1017
A deployment represents a data model, configuration, and managed infrastructure.
1118

1219
To continue with this guide, you'll need to have a Cube Cloud account. If you
@@ -40,7 +47,7 @@ Next, click <Btn>Create</Btn> to create a new project from scratch:
4047
src="https://ucarecdn.com/46b72b61-b650-4271-808d-55203f1c8d8b/"
4148
/>
4249

43-
## Connect to your Snowflake
50+
## Connect to your Snowflake
4451

4552
The last step is to connect Cube Cloud to Snowflake. First, select it from the grid:
4653

docs/content/Getting-Started/Cloud/04-Create-data-model.mdx

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,23 @@ subCategory: Cube Cloud
66
menuOrder: 4
77
---
88

9-
Cube follows a dataset-oriented data modeling approach, which is inspired by and expands upon dimensional modeling.
9+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
10+
11+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake) on Getting Started with Cube Cloud and Snowflake.
12+
Learn how to easily connect Cube Cloud and Snowflake, load your data, and integrate your BI tools.
13+
14+
</InfoBox>
15+
16+
Cube follows a dataset-oriented data modeling approach, which is inspired by and expands upon dimensional modeling.
1017
Cube incorporates this approach and provides a practical framework for implementing dataset-oriented data modeling.
1118

12-
When building a data model in Cube, you work with two dataset-centric objects: **cubes** and **views**.
13-
**Cubes** usually represent business entities such as customers, line items, and orders.
14-
In cubes, you define all the calculations within the measures and dimensions of these entities.
19+
When building a data model in Cube, you work with two dataset-centric objects: **cubes** and **views**.
20+
**Cubes** usually represent business entities such as customers, line items, and orders.
21+
In cubes, you define all the calculations within the measures and dimensions of these entities.
1522
Additionally, you define relationships between cubes, such as "an order has many line items" or "a user may place multiple orders."
1623

17-
**Views** sit on top of a data graph of cubes and create a facade of your entire data model, with which data consumers can interact.
18-
You can think of views as the final data products for your data consumers - BI users, data apps, AI agents, etc.
24+
**Views** sit on top of a data graph of cubes and create a facade of your entire data model, with which data consumers can interact.
25+
You can think of views as the final data products for your data consumers - BI users, data apps, AI agents, etc.
1926
When building views, you select measures and dimensions from different connected cubes and present them as a single dataset to BI or data apps.
2027

2128
<Diagram
@@ -70,10 +77,10 @@ cubes:
7077
7178
As you can see, we already have a `count` measure that we can use to calculate the total count of our orders.
7279

73-
Let's add an additional measure to the `orders` cube to calculate only **completed orders**.
74-
The `status` dimension in the `orders` cube reflects the three possible statuses: **processing**, **shipped**, or **completed**.
75-
We will create a new measure `completed_count` by using a filter on that dimension.
76-
To do this, we will use a [filter parameter](/schema/reference/measures#parameters-filters) of the measure
80+
Let's add an additional measure to the `orders` cube to calculate only **completed orders**.
81+
The `status` dimension in the `orders` cube reflects the three possible statuses: **processing**, **shipped**, or **completed**.
82+
We will create a new measure `completed_count` by using a filter on that dimension.
83+
To do this, we will use a [filter parameter](/schema/reference/measures#parameters-filters) of the measure
7784
and [refer](/data-modeling/syntax#referring-to-objects) to the existing dimension.
7885

7986
Add the following measure definition to your `model/cubes/orders.yml` file. It should be included within the `measures` block.
@@ -168,12 +175,12 @@ views:
168175
169176
- join_path: orders.users
170177
prefix: true
171-
includes:
178+
includes:
172179
- city
173180
- age
174181
- state
175182
```
176183

177184
When building views, you can leverage the `cubes` parameter, which enables you to include measures and dimensions from other cubes in the view. You can build your view by combining multiple joined cubes and specifying the path by which they should be joined for that particular view.
178185

179-
After saving, you can experiment with your newly created view in the Playground. In the next section, we will learn how to query our `orders_view` using a BI tool.
186+
After saving, you can experiment with your newly created view in the Playground. In the next section, we will learn how to query our `orders_view` using a BI tool.

docs/content/Getting-Started/Cloud/05-Add-a-pre-aggregation.mdx

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,13 @@ subCategory: Cube Cloud
66
menuOrder: 6
77
---
88

9+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
10+
11+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake) on Getting Started with Cube Cloud and Snowflake.
12+
Learn how to easily connect Cube Cloud and Snowflake, load your data, and integrate your BI tools.
13+
14+
</InfoBox>
15+
916
In this step, we'll add a pre-aggregation to optimize the performance of a
1017
specific query. Pre-aggregations are a caching technique that massively reduces
1118
query time from seconds to milliseconds. They are extremely useful for speeding

docs/content/Getting-Started/Cloud/05-Query-from-BI.mdx

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,15 @@ subCategory: Cube Cloud
66
menuOrder: 5
77
---
88

9-
You can query Cube using a BI or visualization tool through the Cube SQL API.
10-
To provide a good end-user experience in your BI tool, we recommend mapping the BI's data model to Cube's semantic layer.
9+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
10+
11+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake) on Getting Started with Cube Cloud and Snowflake.
12+
Learn how to easily connect Cube Cloud and Snowflake, load your data, and integrate your BI tools.
13+
14+
</InfoBox>
15+
16+
You can query Cube using a BI or visualization tool through the Cube SQL API.
17+
To provide a good end-user experience in your BI tool, we recommend mapping the BI's data model to Cube's semantic layer.
1118
This can be done automatically with Semantic Layer Sync or manually.
1219

1320
## Semantic Layer Sync
@@ -17,8 +24,8 @@ that correspond to entities within the data model in Cube, such as cubes, views,
1724

1825
<Diagram src="https://ucarecdn.com/c270ae45-d14c-4896-b41f-1ab4973f00f0/" />
1926

20-
Semantic Layer Sync will synchronize all public cubes and views with connected BI tools.
21-
We recommend making your cubes private and only exposing views. Both cubes and views are public by default.
27+
Semantic Layer Sync will synchronize all public cubes and views with connected BI tools.
28+
We recommend making your cubes private and only exposing views. Both cubes and views are public by default.
2229
To make cubes private, set the [public](/schema/reference/cube#parameters-public) parameter to `false`.
2330

2431
```yaml
@@ -28,14 +35,14 @@ cubes:
2835
public: false
2936
```
3037
31-
Let’s create our first Semantic Layer Sync with [Apache Superset](https://superset.apache.org/)!
38+
Let’s create our first Semantic Layer Sync with [Apache Superset](https://superset.apache.org/)!
3239
33-
You can create a new sync by navigating to the <Btn>Semantic Layer Sync</Btn> tab on the <Btn>BI Integrations</Btn> page and clicking <Btn>+ Create Sync</Btn>.
40+
You can create a new sync by navigating to the <Btn>Semantic Layer Sync</Btn> tab on the <Btn>BI Integrations</Btn> page and clicking <Btn>+ Create Sync</Btn>.
3441
Follow the steps in the wizard to create a sync.
3542
3643
Under the hood, Semantic Layer Sync is configured using the `semanticLayerSync` option in the `cube.js` configuration file.
3744

38-
Cube uses the Superset API, which requires a `user` and `password` for authentication.
45+
Cube uses the Superset API, which requires a `user` and `password` for authentication.
3946
You can use your own username and password or create a new service account. You can copy a `URL` from any page of your Superset workspace.
4047

4148
Example `cube.js` configuration file for Superset:
@@ -56,20 +63,20 @@ module.exports = {
5663
};
5764
```
5865

59-
Replace the fields for user, password, and URL with your Superset credentials, then click on <Btn>Save All</Btn>.
66+
Replace the fields for user, password, and URL with your Superset credentials, then click on <Btn>Save All</Btn>.
6067
You can now go to the <Btn>BI Integrations</Btn> page and trigger the synchronization of your newly created semantic layer.
6168

62-
After running the sync, navigate to your Superset instance. You should see the `orders_view` dataset that was created in Superset.
69+
After running the sync, navigate to your Superset instance. You should see the `orders_view` dataset that was created in Superset.
6370
Cube automatically maps all metrics and dimensions in Superset to measures and dimensions in the Cube data model.
6471

6572
## Manual Setup
6673

67-
Alternatively, you can connect to Cube and create all the mappings manually.
74+
Alternatively, you can connect to Cube and create all the mappings manually.
6875
To do this, navigate to your Apache Superset instance and connect to Cube Cloud as if it were a Postgres database.
6976

7077
You can find the credentials to connect to Cube on the <Btn>BI Integrations</Btn> page under the <Btn>SQL API Connection</Btn> tab.
7178

72-
After connecting, create a new dataset in Superset and select "orders_view" as a table.
79+
After connecting, create a new dataset in Superset and select "orders_view" as a table.
7380
Now you can map Superset metrics and columns to Cube's measures and dimensions.
7481

7582
<Diagram
@@ -84,4 +91,4 @@ As you can see, we use the `MEASURE` function in the "SQL expression" field. Thi
8491
src="https://ucarecdn.com/fd8e69e6-0a01-4ed9-8deb-848efb8a7e7f/"
8592
/>
8693

87-
In the next section, we will learn how to use Cube's REST API to query our view from a React app.
94+
In the next section, we will learn how to use Cube's REST API to query our view from a React app.

docs/content/Getting-Started/Cloud/06-Learn-more.mdx

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,13 @@ subCategory: Cube Cloud
66
menuOrder: 7
77
---
88

9+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
10+
11+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake) on Getting Started with Cube Cloud and Snowflake.
12+
Learn how to easily connect Cube Cloud and Snowflake, load your data, and integrate your BI tools.
13+
14+
</InfoBox>
15+
916
Now that you've set up your first deployment, learn more about other Cube Cloud
1017
feaures.
1118

docs/docs-new/pages/product/configuration/data-sources/snowflake.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,14 @@ redirect_from:
55

66
# Snowflake
77

8+
<InfoBox heading="Get Started with Cube Cloud & Snowflake">
9+
10+
[Join our upcoming Office Hours on July 26 at 9am PST](https://cube.dev/events/unlock-data-cube-snowflake)
11+
on Getting Started with Cube Cloud and Snowflake. Learn how to easily connect
12+
Cube Cloud and Snowflake, load your data, and integrate your BI tools.
13+
14+
</InfoBox>
15+
816
## Prerequisites
917

1018
- [The account ID][snowflake-docs-account-id] for [Snowflake][snowflake]

docs/docs-new/pages/product/getting-started.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,12 +20,12 @@ Alternatively, you can run Cube on your own infrastructure with Docker.
2020

2121
<Grid cols={2} imageSize={[undefined, 50]}>
2222
<GridItem
23-
url="getting-started/cloud"
23+
url="getting-started/cloud/overview"
2424
imageUrl="https://static.cube.dev/icons/cube.svg"
2525
title="Cube Cloud"
2626
/>
2727
<GridItem
28-
url="getting-started/core"
28+
url="getting-started/core/overview"
2929
imageUrl="https://static.cube.dev/icons/docker.svg"
3030
title="Cube Core"
3131
/>

0 commit comments

Comments
 (0)