-
Notifications
You must be signed in to change notification settings - Fork 944
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
Update gsheets.md #5378
Changes from 10 commits
6e2fa4c
1d4c75c
534ac65
276dd2d
d5f5140
572083b
f9ef111
1409676
acd6fb5
740d175
b47f769
238977d
0c01480
c2a8d51
9d95419
dcd0373
8f584f3
30ee591
d341f41
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change | ||||
---|---|---|---|---|---|---|
@@ -1,8 +1,8 @@ | ||||||
--- | ||||||
title: "Google Sheets (beta)" | ||||||
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
|
||||||
|
@@ -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. | ||||||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. By There was a problem hiding this comment. Choose a reason for hiding this commentThe 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 There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Correct. Anything that's not metric_time! There was a problem hiding this comment. Choose a reason for hiding this commentThe 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
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. should we say 'For non-metric time dimensions, use the "where"...'? There was a problem hiding this comment. Choose a reason for hiding this commentThe 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** | ||||||
|
||||||
|
@@ -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 | ||||||
|
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -11,7 +11,7 @@ The following tools integrate with the dbt Semantic Layer: | |
icon="tableau-software"/> | ||
|
||
<Card | ||
title="Google Sheets (Preview)" | ||
title="Google Sheets" | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe 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 |
||
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"/> | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
🚀