Skip to content

Commit

Permalink
Merge branch 'current' into athena-reference
Browse files Browse the repository at this point in the history
  • Loading branch information
matthewshaver authored Aug 29, 2024
2 parents f5c5d6c + 0986a76 commit 8ee6ba1
Show file tree
Hide file tree
Showing 6 changed files with 20 additions and 18 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -39,9 +39,9 @@ import Tools from '/snippets/_sl-excel-gsheets.md';
type="Microsoft Excel"
bullet_1="There's a timeout of 1 minute for queries."
bullet_2="If you're using this extension, make sure you're signed into Microsoft with the same Excel profile you used to set up the Add-In. Log in with one profile at a time as using multiple profiles at once might cause issues."
queryBuilder="/img/docs/dbt-cloud/semantic-layer/query-builder.png"
/>

<!-- placeholder for excel image URL prop: queryBuilder="/img/docs/dbt-cloud/semantic-layer/sl-and-gsheets.jpg"-->

## FAQs
<FAQ path="Troubleshooting/sl-alpn-error" />
14 changes: 8 additions & 6 deletions website/docs/docs/cloud-integrations/semantic-layer/gsheets.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,13 +40,15 @@ import Tools from '/snippets/_sl-excel-gsheets.md';
type="Google Sheets"
bullet_1="The custom menu operation has a timeout limit of six (6) minutes."
bullet_2="If you're using this extension, make sure you're signed into Chrome with the same Google profile you used to set up the Add-On. Log in with one Google profile at a time as using multiple Google profiles at once might cause issues."
queryBuilder="/img/docs/dbt-cloud/semantic-layer/gsheets-query-builder.jpg"
queryBuilder="/img/docs/dbt-cloud/semantic-layer/query-builder.png"
PrivateSelections="You can also make these selections private or public. Public selections mean your inputs are available in the menu to everyone on the sheet.
Private selections mean your inputs are only visible to you. Note that anyone added to the sheet can still see the data from these private selections, but they won't be able to interact with the selection in the menu or benefit from the automatic refresh."
/>

<!-- adding this section here temporarily (not incl limited policy) until saved queries is available for excel. when saved queries becomes available for excel365 integration:
1. remove the below content (tip and using saved queries header
2. then go to the website/snippets/_sl-excel-gsheets.md snippet
3. And uncomment line 97 - 118 to make saved queries content available to gsheets AND excel -->
<!-- this comment explains the following:
1. uses the /snippets/_sl-excel-gsheets.md snippet file to render gsheets and excel content since they're similar
2. removes the below content (tip and using saved queries header) so it's not duplicative. removing the below content fully a month or so after the launch.
3. keep tje limited policy section in gsheets only and do not add to the /snippets/_sl-excel-gsheets.md snippet file.
## Using saved selections
Expand All @@ -56,7 +58,6 @@ Saved selections allow you to save inputs in the **Query Builder** to easily acc
- Save the selection by selecting the arrow next to the **Query** button and then select **Query & Save Selection**.
- The application saves these selections, allowing you to view and edit them from the hamburger menu under **Saved Selections**.
<Lightbox src="/img/docs/dbt-cloud/semantic-layer/gsheets-query-builder.jpg" width="25%" title="Query and save selections in the Query Builder using the arrow next to the Query button." />
You can also make these selections private or public:
Expand All @@ -83,6 +84,7 @@ Access <a href="/docs/build/saved-queries">saved queries</a>, powered by MetricF
- Navigate to **Saved Queries** to access the ones available to you.
- You can also select **Build Selection**, which allows you to explore the existing query. This won't change the original query defined in the code.
- If you use a [`where` filter](/docs/build/saved-queries#where-clause) in a saved query, Google Sheets displays the advanced syntax for this filter.
-->

**Limited use policy disclosure**

Expand Down
18 changes: 7 additions & 11 deletions website/snippets/_sl-excel-gsheets.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,26 +65,24 @@
<li>For time dimensions, you can use the time range selector to filter on presets or custom options. The time range selector applies only to the primary time dimension (<code>metric_time</code>). For all other time dimensions that aren't <code>metric_time</code>, you can use the "Where" option to apply filters.</li>
</ul>

#### Other settings
#### Other settings

<p>If you would like to just query the data values without the headers, you can optionally select the <strong>Exclude Column Names</strong> box.</p>
<p>To return your results and keep any previously selected data below it intact, un-select the <strong>Exclude Column Names</strong> box. By default, we'll clear all trailing rows if there's stale data. </p>
<p>If you would like to just query the data values without the headers, you can optionally select the <strong>Exclude column names</strong> box.</p>
<p>To return your results and keep any previously selected data below it intact, un-select the <strong>Clear trailing rows</strong> box. By default, we'll clear all trailing rows if there's stale data.</p>



<!-- hide this content for initial launch
<Lightbox src={ props.queryBuilder } width="35%" title="Run a query in the Query Builder. Use the arrow next to the Query button to select additional settings." />

## Using saved selections

<p><span>Saved selections allow you to save the inputs you've created in the {props.type} <strong>Query Builder</strong> and easily access them again so you don't have to continuously build common queries from scratch. To create a saved selection:</span></p>

<ol>
<li>Run a <span>query in the {props.type} <strong>Query Builder</strong>.</span></li>
<li>Run a <span>query in the <strong>Query Builder</strong>.</span></li>
<li>Save the selection by selecting the arrow next to the <strong>Query</strong> button and then select <strong>Query & Save Selection</strong>.</li>
<li>The application saves these selections, allowing you to view and edit them from the hamburger menu under <strong>Saved Selections</strong>.</li>
</ol>

<Lightbox src={ props.queryBuilder } width="25%" title="Query and save selections in the Query Builder using the arrow next to the Query button." />
<p><span>{props.PrivateSelections}</span></p>

### Refreshing selections

Expand All @@ -105,10 +103,8 @@
<ol>
<li>Open the hamburger menu in {props.type}.</li>
<li>Navigate to <strong>Saved Queries</strong> to access the ones available to you.</li>
<li>You can also select <strong>Build Selection</strong>, which allows you to explore the existing query. This won't change the original query defined in the code.
<li>You can also select <strong>Build Selection</strong>, which allows you to explore the existing query. This won't change the original query defined in the code.</li>
<ul>
<li>If you use a <code>WHERE</code> filter in a saved query, {props.type} displays the advanced syntax for this filter.</li>
</ul>
</li>
</ol>
-->
4 changes: 4 additions & 0 deletions website/src/css/custom.css
Original file line number Diff line number Diff line change
Expand Up @@ -705,6 +705,10 @@ html[data-theme="dark"] .alert table {
color: var(--ifm-color-gray-900) !important;
}

.alert blockquote {
color: inherit;
}

.linkout {
background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' viewBox='0 0 18 22.5' version='1.1' x='0px' y='0px'%3E%3Ctitle%3Elink%3C/title%3E%3Cdesc%3ECreated with Sketch.%3C/desc%3E%3Cg stroke='none' stroke-width='1' fill='none' fill-rule='evenodd'%3E%3Cpath d='M9.24264069,6.41438508 C8.8521164,6.80490937 8.21895142,6.80490937 7.82842712,6.41438508 C7.43790283,6.02386078 7.43790283,5.39069581 7.82842712,5.00017151 L10.6570258,2.17157288 C12.2191229,0.609475708 14.7517828,0.609475708 16.31388,2.17157288 C17.8759772,3.73367004 17.8759772,6.26632996 16.31388,7.82842712 L13.4854529,10.6568542 C13.0949286,11.0473785 12.4617636,11.0473785 12.0712393,10.6568542 C11.680715,10.26633 11.680715,9.63316498 12.0712393,9.24264069 L14.8996664,6.41421356 C15.680715,5.63316498 15.680715,4.36683502 14.8996664,3.58578644 C14.1186179,2.80473785 12.8522879,2.80473785 12.0712393,3.58578644 L9.24264069,6.41438508 Z M9.2428122,12.0710678 C9.63333649,11.6805435 10.2665015,11.6805435 10.6570258,12.0710678 C11.0475501,12.4615921 11.0475501,13.0947571 10.6570258,13.4852814 L7.82842712,16.31388 C6.26632996,17.8759772 3.73367004,17.8759772 2.17157288,16.31388 C0.609475708,14.7517828 0.609475708,12.2191229 2.17157288,10.6570258 L5,7.82859864 C5.39052429,7.43807435 6.02368927,7.43807435 6.41421356,7.82859864 C6.80473785,8.21912293 6.80473785,8.85228791 6.41421356,9.2428122 L3.58578644,12.0712393 C2.80473785,12.8522879 2.80473785,14.1186179 3.58578644,14.8996664 C4.36683502,15.680715 5.63316498,15.680715 6.41421356,14.8996664 L9.2428122,12.0710678 Z M12.0712393,6.41421356 C12.4617636,6.80473785 12.4617636,7.43790283 12.0712393,7.82842712 L7.82859864,12.0710678 C7.43807435,12.4615921 6.80490937,12.4615921 6.41438508,12.0710678 C6.02386078,11.6805435 6.02386078,11.0473785 6.41438508,10.6568542 L10.6570258,6.41421356 C11.0475501,6.02368927 11.680715,6.02368927 12.0712393,6.41421356 Z' fill='%23000000' fill-rule='nonzero'/%3E%3C/g%3E%3C/svg%3E");
background-size: 2rem 2rem;
Expand Down
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 8ee6ba1

Please sign in to comment.