Update sl-jdbc.md #3953

rpourzand · 2023-08-18T22:57:02Z

update to filter list for WHERE
updates for the ability to get the agg_time_dimension name for measures
updates for the ability to get queryable granularities for more than just a primary time dim

What are you changing in this pull request and why?

Checklist

Review the Content style guide and About versioning so my content adheres to these guidelines.
Add a checklist item for anything that needs to happen before this PR is merged, such as "needs technical review" or "change base branch."

Adding new pages (delete if not applicable):

Add page to website/sidebars.js
Provide a unique filename for the new page

Removing or renaming existing pages (delete if not applicable):

Remove page from website/sidebars.js
Add an entry website/static/_redirects
Ran link testing to update the links that point to the deleted page

- update to filter list for WHERE - update to examples with where - updates for using Dimension() AND TimeDimension() in where clause

netlify · 2023-08-18T22:57:09Z

✅ Deploy Preview for docs-getdbt-com ready!

Name	Link
🔨 Latest commit	`826b267`
🔍 Latest deploy log	https://app.netlify.com/sites/docs-getdbt-com/deploys/64fedd5c82a4de00085d8598
😎 Deploy Preview	https://deploy-preview-3953--docs-getdbt-com.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

mirnawong1 · 2023-08-23T13:04:35Z

website/docs/docs/dbt-cloud-apis/sl-jdbc.md

@@ -215,21 +215,33 @@ select * from {{

 ### Query with where filters

-Where filters have three components: 
+Where filters in API allow for a filter list or string. We recommend using the filter list for production application as this format will realize all benefits from predicate pushdown where possible. 


@rpourzand , what does predicate mean in this sentence?

Suggested change

Where filters in API allow for a filter list or string. We recommend using the filter list for production application as this format will realize all benefits from predicate pushdown where possible.

In the API, you can use where filters either as a filter list or string. For production applications, it's better to use a filter list. This format helps you take advantage of all the benefits from the predicate pushdown where possible.

So a predicate is just an expression to determine what rows in a database apply to a particular query. For example, if I filter in a WHERE clause on a particular dimension value, the database is basically going to search to determine what values in the DB apply to this query. If this can be pushed down to the database (predicate pushdown)), it's much faster.

We could link out some generic docs on predicate pushdown.

Predicate Pushdown points to the where or filter clause which affects the number of rows returned. It basically relates to which rows will be filtered, not which columns. For this reason, while applying the filter on a nested column as ‘library.books’ to merely return records with the values that are not null, the predicate pushdown function will make parquet read blocks that contain no null values for the specified column.

website/docs/docs/dbt-cloud-apis/sl-jdbc.md

mirnawong1 · 2023-08-23T13:15:55Z

lgtm!

updated with a queryable granularity example

adding the query Courtney introduced to get the name of the agg time dimension

add predicate pushdown term to use in docs

vercel · 2023-09-05T14:08:59Z

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
docs-getdbt-com	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Sep 19, 2023 9:45pm

website/docs/docs/dbt-cloud-apis/sl-jdbc.md

mirnawong1 · 2023-09-11T09:27:05Z

waiting until roxi is back from ooo

removing one set of changes from this PR since it won't be shipped until a little later

typos

rpourzand · 2023-09-19T17:49:45Z

hey @mirnawong1 I edited this one to remove some things that are still in flight, so pending your final review it can be shipped

mirnawong1

lgtm @rpourzand ! happy to merge this for you if you're ok with it! ✨

Update sl-jdbc.md

8176b66

- update to filter list for WHERE - update to examples with where - updates for using Dimension() AND TimeDimension() in where clause

rpourzand requested a review from a team as a code owner August 18, 2023 22:57

github-actions bot added content Improvements or additions to content size: small This change will take 1 to 2 days to address and removed content Improvements or additions to content labels Aug 18, 2023

mirnawong1 reviewed Aug 23, 2023

View reviewed changes

website/docs/docs/dbt-cloud-apis/sl-jdbc.md Outdated Show resolved Hide resolved

Update website/docs/docs/dbt-cloud-apis/sl-jdbc.md

678daaf

github-actions bot added the content Improvements or additions to content label Aug 23, 2023

mirnawong1 reviewed Aug 23, 2023

View reviewed changes

website/docs/docs/dbt-cloud-apis/sl-jdbc.md Outdated Show resolved Hide resolved

Update website/docs/docs/dbt-cloud-apis/sl-jdbc.md

9c850c7

mirnawong1 reviewed Aug 23, 2023

View reviewed changes

website/docs/docs/dbt-cloud-apis/sl-jdbc.md Outdated Show resolved Hide resolved

mirnawong1 added 2 commits August 23, 2023 14:08

Update website/docs/docs/dbt-cloud-apis/sl-jdbc.md

8f458f6

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

59a4c76

rpourzand requested a review from DevonFulcher August 28, 2023 22:22

mirnawong1 and others added 3 commits August 29, 2023 09:51

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

fd53519

Update sl-jdbc.md

832a64a

updated with a queryable granularity example

Update sl-jdbc.md

78f4276

adding the query Courtney introduced to get the name of the agg time dimension

github-actions bot added size: medium This change will take up to a week to address and removed size: small This change will take 1 to 2 days to address labels Aug 29, 2023

mirnawong1 and others added 6 commits August 31, 2023 11:00

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

d7525ac

Create predicate-pushdown.md

86f9593

add predicate pushdown term to use in docs

Update predicate-pushdown.md

33800bb

clarify predicate pushdown and add term

5d68215

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

2bdfdd1

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

6f5e46e

marcodamore approved these changes Sep 5, 2023

View reviewed changes

mirnawong1 reviewed Sep 5, 2023

View reviewed changes

website/docs/docs/dbt-cloud-apis/sl-jdbc.md Outdated Show resolved Hide resolved

mirnawong1 added 3 commits September 5, 2023 15:17

Update website/docs/docs/dbt-cloud-apis/sl-jdbc.md

97bd5a1

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

ae83b1f

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

826b267

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

968be37

vercel bot deployed to Preview September 18, 2023 15:36 View deployment

rpourzand added 2 commits September 18, 2023 15:36

Update sl-jdbc.md

e53523c

removing one set of changes from this PR since it won't be shipped until a little later

Update sl-jdbc.md

86ac6dd

typos

vercel bot deployed to Preview September 18, 2023 22:52 View deployment

Update sl-jdbc.md

de2e325

vercel bot deployed to Preview September 19, 2023 09:21 View deployment

mirnawong1 added 3 commits September 19, 2023 19:08

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

bfe1f3f

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

58ba503

Update sl-jdbc.md

15f9d70

mirnawong1 approved these changes Sep 19, 2023

View reviewed changes

mirnawong1 enabled auto-merge September 19, 2023 18:24

mirnawong1 disabled auto-merge September 19, 2023 18:24

vercel bot deployed to Preview September 19, 2023 18:30 View deployment

mirnawong1 added 2 commits September 19, 2023 22:31

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

35c22e6

Merge branch 'current' into rpourzand-jdbc-updates-where-filters

6d5be30

mirnawong1 enabled auto-merge September 19, 2023 21:32

vercel bot deployed to Preview September 19, 2023 21:45 View deployment

mirnawong1 merged commit a757e5a into current Sep 19, 2023
7 checks passed

mirnawong1 deleted the rpourzand-jdbc-updates-where-filters branch September 19, 2023 21:45

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update sl-jdbc.md #3953

Update sl-jdbc.md #3953

rpourzand commented Aug 18, 2023 •

edited

Loading

netlify bot commented Aug 18, 2023 •

edited

Loading

mirnawong1 Aug 23, 2023 •

edited

Loading

rpourzand Aug 23, 2023

rpourzand Aug 23, 2023

mirnawong1 Aug 31, 2023

mirnawong1 commented Aug 23, 2023

vercel bot commented Sep 5, 2023 •

edited

Loading

mirnawong1 commented Sep 11, 2023

rpourzand commented Sep 19, 2023

mirnawong1 left a comment

	Where filters in API allow for a filter list or string. We recommend using the filter list for production application as this format will realize all benefits from predicate pushdown where possible.
	In the API, you can use where filters either as a filter list or string. For production applications, it's better to use a filter list. This format helps you take advantage of all the benefits from the predicate pushdown where possible.

Update sl-jdbc.md #3953

Update sl-jdbc.md #3953

Conversation

rpourzand commented Aug 18, 2023 • edited Loading

What are you changing in this pull request and why?

Checklist

netlify bot commented Aug 18, 2023 • edited Loading

✅ Deploy Preview for docs-getdbt-com ready!

mirnawong1 Aug 23, 2023 • edited Loading

Choose a reason for hiding this comment

rpourzand Aug 23, 2023

Choose a reason for hiding this comment

rpourzand Aug 23, 2023

Choose a reason for hiding this comment

mirnawong1 Aug 31, 2023

Choose a reason for hiding this comment

mirnawong1 commented Aug 23, 2023

vercel bot commented Sep 5, 2023 • edited Loading

mirnawong1 commented Sep 11, 2023

rpourzand commented Sep 19, 2023

mirnawong1 left a comment

Choose a reason for hiding this comment

rpourzand commented Aug 18, 2023 •

edited

Loading

netlify bot commented Aug 18, 2023 •

edited

Loading

mirnawong1 Aug 23, 2023 •

edited

Loading

vercel bot commented Sep 5, 2023 •

edited

Loading