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
Show file tree
Hide file tree
Changes from 10 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 use the time range selector to filter on the primary time dimension with preset or custom options. For non-primary time dimensions, use the "Where" option to apply filters.
Copy link
Contributor

Choose a reason for hiding this comment

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

By non-primary time dimensions, do you mean non-metric time dimensions? The time range only works for metric time.

Copy link
Contributor

Choose a reason for hiding this comment

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

i changed it and i think the original was '...to filter on time dimensions that are not the primary time series for the metrics.' maybe i should add 'series for metrics' at the end

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Correct. Anything that's not metric_time!

Copy link
Contributor

@mirnawong1 mirnawong1 Apr 29, 2024

Choose a reason for hiding this comment

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

it sounds a little awkward so am going to wait for @rpourzand

Suggested change
For time dimensions, you can use the time range selector to filter on the primary time dimension with preset or custom options. For non-primary time dimensions, use the "Where" option to apply filters.
For time dimensions, you can use the time range selector to filter on the primary time dimension with preset or custom options. For non-primary time dimension series for metrics, use the "Where" option to apply filters.

Copy link
Contributor

Choose a reason for hiding this comment

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

should we say 'For non-metric time dimensions, use the "where"...'?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ok I tweaked a bit! let me know your thoughts


**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
2 changes: 1 addition & 1 deletion website/snippets/_sl-partner-links.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ The following tools integrate with the dbt Semantic Layer:
icon="tableau-software"/>

<Card
title="Google Sheets (Preview)"
title="Google Sheets"
Copy link
Contributor

Choose a reason for hiding this comment

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

removed the 'preview' mention from the main avail integrations card parge too @rpourzand

Screenshot 2024-04-29 at 17 05 31

link="/docs/use-dbt-semantic-layer/gsheets"
body="Discover how to connect to Google Sheets for querying metrics and collaborating with your team."
icon="google-sheets-logo-icon"/>
Expand Down
Loading