Skip to content

Conversation

@techdocsmith
Copy link
Contributor

@techdocsmith techdocsmith commented Jan 27, 2025

Description

Adds examples for window functions to the SQL reference

This PR has:

  • been self-reviewed.
  • added documentation for new or modified features or behaviors.
  • a release note entry in the PR description.
  • added Javadocs for most classes and all non-trivial methods. Linked related entities via Javadoc links.
  • added or updated version, license, or notice information in licenses.yaml
  • added comments explaining the "why" and the intent of the code wherever would not be obvious for an unfamiliar reader.
  • added unit tests or modified existing tests to cover new code paths, ensuring the threshold for code coverage is met.
  • added integration tests.
  • been tested in a test Druid cluster.

@techdocsmith techdocsmith requested a review from vtlim January 27, 2025 18:32
@vtlim vtlim changed the title [Docs] Adds examples for window functions for the SQL Reference (batch230 [Docs] Adds examples for window functions for the SQL Reference (batch23) Jan 27, 2025
Copy link
Member

@vtlim vtlim left a comment

Choose a reason for hiding this comment

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

Examples look great. Some nits on labels

techdocsmith and others added 3 commits January 28, 2025 14:26
Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>
Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>
@vtlim vtlim merged commit 56702ce into apache:master Jan 28, 2025
6 checks passed
vtlim added a commit to vtlim/druid that referenced this pull request Feb 3, 2025
…h23) (apache#17670)

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>
317brian pushed a commit to 317brian/druid that referenced this pull request Feb 3, 2025
…h23) (apache#17670)

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>
techdocsmith added a commit that referenced this pull request Feb 7, 2025
* docs: Restore SQL function examples (#17293)

* docs: add examples for SQL functions (#16745)

* updating first batch of numeric functions

* First batch of functions

* addressing first few comments

* alphabetize list

* draft with suggestions applied

* minor discrepency expr -> <NUMERIC>

* changed raises to calculates

* Update docs/querying/sql-functions.md

* switch to underscore

* changed to exp(1) to match slack message

* adding html text for trademark symbol to .spelling

* fixed discrepancy between description and example

---------

Co-authored-by: Benedict Jin <asdf2014@apache.org>
(cherry picked from commit 721a650)

* [docs] batch02 of updating functions (#16761)

* applying changes

* ensuring batch is updated

* Update docs/querying/sql-functions.md

* raise -> raises

* addressing review

* Apply suggestions from code review

Co-authored-by: Charles Smith <techdocsmith@gmail.com>

---------

Co-authored-by: Benedict Jin <asdf2014@apache.org>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>
(cherry picked from commit ca78788)

* [Docs] batch 03 - trig functions (#16795)

* batch 03 - trig functions

* Apply suggestions from code review

Co-authored-by: Charles Smith <techdocsmith@gmail.com>

* applying suggestions and corrections

---------

Co-authored-by: Charles Smith <techdocsmith@gmail.com>
(cherry picked from commit 028ee23)

* [Docs]Batch04 - Bitwise numeric functions (#16805)

* Batch04 - Bitwise numeric functions

* Batch04 - Bitwise numeric functions

* minor fixes

* rewording bitwise_shift functions

* rewording bitwise_shift functions

* Update docs/querying/sql-functions.md

* applying suggestions

---------

Co-authored-by: Benedict Jin <asdf2014@apache.org>
(cherry picked from commit 85a8a1d)

* [docs] batch 5 updating functions (#16812)

* batch 5

* Update docs/querying/sql-functions.md

* applying suggestions

---------

Co-authored-by: Benedict Jin <asdf2014@apache.org>
(cherry picked from commit 3bb6d40)

* [Docs] Batch06: starting string functions (#16838)

* batch06, starting string functions

* addind space after Syntax

* quick change

* correcting spelling

* Update docs/querying/sql-functions.md

* Update sql-functions.md

* applying suggestions

* Update docs/querying/sql-functions.md

* Update docs/querying/sql-functions.md

---------

Co-authored-by: Benedict Jin <asdf2014@apache.org>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>
(cherry picked from commit ebea34a)

* [Docs] Batch08: adding examples to string functions (#16871)

* batch08 completed

* reviewing batch08

* apply corrections suggestions by @FrankChen021

(cherry picked from commit 5b94839)

* [Docs] Batch07: adding examples to string functions (#16862)

* Lower,Upper,Lpad,Rpad,Parse_long

* up to REGEXP_EXTRACT

* batch 07 ready for review

* updated definitions in scalar

* Apply suggestions from code review

Co-authored-by: Charles Smith <techdocsmith@gmail.com>

* rpad and lpad

* addressing comments

* minor fixes

* improving examples based on suggestions

* matched -> matches

* correcting typo

* Apply suggestions from code review

Co-authored-by: Charles Smith <techdocsmith@gmail.com>

---------

Co-authored-by: Charles Smith <techdocsmith@gmail.com>
(cherry picked from commit 7256953)

* [Docs] Batch09: only `lookup` (#16878)

* [Docs] Batch09: only `lookup`

* slight changes

* Apply suggestions from code review

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* applying suggestiontions

* Apply suggestions from code review

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>

* otherwise null -> otherwise returns null

* updating definition in sql-scalar.md

* Apply suggestions from code review

Co-authored-by: Charles Smith <techdocsmith@gmail.com>

* hoping to re-run web checks

* change replaceMissingValueWith -> defaultValue

* Update docs/querying/sql-scalar.md

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* acronym_to_name -> airportcode_to_name

* shortens `airportcode_to_name` to `code_to_name`

---------

Co-authored-by: Katya Macedo <38017980+ektravel@users.noreply.github.com>
Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>
(cherry picked from commit fda2d19)

* [docs] Batch10 date and time functions (#16900)

* just starting

* TIME_PARSE and TIME_FORMAT remaining

* fixing typo

* adding last two functions

* review sql-functions.md

* Apply suggestions from code review

Suggestions that were accepted as is

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* Update docs/querying/sql-functions.md

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* Update docs/querying/sql-functions.md

needed to confirm that it did indeed return as a number

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* reviewing remaining suggestions

* addressing review for time_format

* Apply suggestions from code review

Accepted as is

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* addressing final suggestion

* time_zone -> timezone

* timezone fix

---------

Co-authored-by: Katya Macedo <38017980+ektravel@users.noreply.github.com>
(cherry picked from commit c4981e3)

* [docs] batch 12: reduction functions (#16930)

* [docs] batch 12: reduction functions

* Update docs/querying/sql-functions.md

* Update docs/querying/sql-functions.md

* Update docs/querying/sql-functions.md

* applying suggestions

* Apply suggestions from code review

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

---------

Co-authored-by: Benedict Jin <asdf2014@apache.org>
Co-authored-by: Katya Macedo <38017980+ektravel@users.noreply.github.com>
(cherry picked from commit c49dc83)

* [docs] Batch13 IP functions (#16947)

* new datasource

* reviewing before pr

* Update docs/querying/sql-functions.md

* Apply suggestions from code review

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Charles Smith <techdocsmith@gmail.com>

* Applying suggestions to IPV4_PARSE

---------

Co-authored-by: Benedict Jin <asdf2014@apache.org>
Co-authored-by: Katya Macedo <38017980+ektravel@users.noreply.github.com>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>
(cherry picked from commit ed81126)

* [docs] Batch11 date and time functions (#16926)

* first draft of functions

* minor improvments

* Update docs/querying/sql-functions.md

* Update docs/querying/sql-scalar.md

* Apply suggestions from code review

Accepted as is

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* applying next round of suggestions

* fixing missing column name

* addressing floor and ceil functions

* Apply suggestions from code review

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>

* re-wording TIMESTAMPADD

---------

Co-authored-by: Benedict Jin <asdf2014@apache.org>
Co-authored-by: Katya Macedo <38017980+ektravel@users.noreply.github.com>
(cherry picked from commit 2d9e92c)

* Update docs/querying/sql-functions.md

* Update docs/querying/sql-functions.md

Co-authored-by: Benedict Jin <asdf2014@apache.org>

* [docs] Batches 14-16, 18: HLL, Theta, Quantiles, other (#93)

Co-authored-by: Katya Macedo  <38017980+ektravel@users.noreply.github.com>
Co-authored-by: edgar2020 <evmelendrez@gmail.com>
Co-authored-by: Katya Macedo <38017980+ektravel@users.noreply.github.com>
Co-authored-by: Katya Macedo <katya.macedo@imply.io>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>

* batches 20 21 24 25

* fix unnest list

* Add LISTAGG to spelling

* cherry pick batch 21

* cherry pick batch 21

---------

Co-authored-by: Edgar Melendrez <evmelendrez@gmail.com>
Co-authored-by: Edgar Melendrez <edgar.melendrez@imply.io>
Co-authored-by: Benedict Jin <asdf2014@apache.org>
Co-authored-by: Katya Macedo <38017980+ektravel@users.noreply.github.com>
Co-authored-by: Katya Macedo <katya.macedo@imply.io>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>

* fix typo (#17663)

* add tuple examples (#17667)

* docs: fix typos in tabs and header (#17673)

* [docs] Batch26 JSON functions (#17635)

* [docs] Batch26 JSON functions

* Updated

* Updated

* Updated

* Fixed typo

* Small wording update

* Updated after review

---------

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>

* [Docs] Adds examples for window functions for the SQL Reference (batch23) (#17670)

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>

* [docs] Batch19 SQL aggregation functions (#17658)

* Batch19 SQL aggregation functions

* Updated

* Updated

* Update docs/querying/sql-functions.md

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>

* Updated after review

* Removed some problematic italics

* Updated after review

* Update docs/querying/sql-functions.md

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>

* Update docs/querying/sql-functions.md

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>

* Capitalize Bloom

* Apply suggestions from code review

Apply suggestions

* fix backticks

---------

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>

---------

Co-authored-by: Edgar Melendrez <evmelendrez@gmail.com>
Co-authored-by: Edgar Melendrez <edgar.melendrez@imply.io>
Co-authored-by: Benedict Jin <asdf2014@apache.org>
Co-authored-by: Katya Macedo <38017980+ektravel@users.noreply.github.com>
Co-authored-by: Katya Macedo <katya.macedo@imply.io>
Co-authored-by: Charles Smith <techdocsmith@gmail.com>
Co-authored-by: Jill Osborne <jill.osborne@imply.io>
@kgyrtkirk kgyrtkirk added this to the 33.0.0 milestone Apr 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants