Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update gsheets.md #5378

Merged
merged 19 commits into from
May 3, 2024
Merged
Changes from 7 commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 13 additions & 9 deletions website/docs/docs/use-dbt-semantic-layer/gsheets.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: "Google Sheets (beta)"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚀

title: "Google Sheets"
description: "Integrate with Google Sheets to query your metrics in a spreadsheet."
tags: [Semantic Layer]
sidebar_label: "Google Sheets (Preview)"
sidebar_label: "Google Sheets"
---

# Google Sheets <Lifecycle status='preview'/>
mirnawong1 marked this conversation as resolved.
Show resolved Hide resolved
Expand Down Expand Up @@ -53,18 +53,22 @@ The Google Sheets **Query Builder** custom menu has the following capabilities:
| Menu items | Description |
|---------------|-------------------------------------------------------|
| Metrics | Search and select metrics. |
| Group By | Search and select dimensions or entities to group by. Dimensions are grouped by the entity of the semantic model they come from. |
| Time Range | Quickly select time ranges to look at the data, which applies to the main time series for the metrics (metric time). You can still optionally use `where` to filter time ranges|
| Group By | Search and select dimensions or entities to group by. Dimensions are grouped by the entity of the semantic model they come from. You may choose dimensions on their own without metrics. |
| Time Range | Quickly select time ranges to look at the data, which applies to the main time series for the metrics (metric time), or do more advanced filter using the "Custom" selection|
| Granularity | Modify the granularity of the primary time dimension. |
| Where | Filter your data. This includes categorical and time filters. |
| Order By | Return your data order. |
| Limit | Set a limit for the rows of your output. |



**Filtering data**

To use the filter functionality, choose the [dimension](docs/build/dimensions) you want to filter by and select the operation you want to filter on.
- For categorical dimensions, type in the dimension value you want to filter by (no quotes needed) and press enter.
- Continue adding additional filters as needed with AND and OR. If it's a time dimension, choose the operator and select from the calendar.
- For categorical dimensions, you can type a value into search or select from a populated list. For entities, you must type the value you are looking for as we do not load all of them given the large number of values.
- Continue adding additional filters as needed with AND and OR.

For time dimensions, you can filter on the primary time dimension using the time range selector which offers presets, or use "custom" for additional options. You can also use the "Where" option to filter on time dimensions that are not the primary time series for the metrics.
mirnawong1 marked this conversation as resolved.
Show resolved Hide resolved

**Querying without headers or columns**

Expand All @@ -85,14 +89,14 @@ You can also make these selections private or public:

### Refreshing selections

Set your saved selections to automatically refresh every time you load the addon. You can do this by selecting **Refresh on Load** when creating the saved selection.
Set your saved selections to automatically refresh every time you load the addon. You can do this by selecting **Refresh on Load** when creating the saved selection. When you access the addon and have saved selections that should refresh, you'll see "Loading..." in the cells that are refreshing.

Public saved selections will refresh for anyone who edits the sheet, while private selections will only update for the user who created it.
Public saved selections will refresh for anyone who edits the sheet while private selections will only update for the user who created it.

:::tip What's the difference between saved queries and saved selections?

- Saved selections are saved components that you can create only when using the Google Sheets application.
- Saved queries, explained in the next section, are code-defined sections of data that you can easily access. You can use the results from a saved query to create a saved selection.
- Saved queries, explained in the next section, are code-defined sections of data you create in your dbt project that you can easily access and use for building selections. You can also use the results from a saved query to create a saved selection.
:::

## Using saved queries
Expand Down
Loading