-
Notifications
You must be signed in to change notification settings - Fork 28.9k
[SPARK-31305][SQL][DOCS] Add a page to list all commands in SQL Reference #28074
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
Conversation
|
Test build #120602 has finished for PR 28074 at commit
|
|
Test build #120605 has finished for PR 28074 at commit
|
docs/sql-ref-syntax.md
Outdated
| Spark SQL is Apache Spark's module for working with structured data. The SQL Syntax section describes the SQL syntax in detail along with usage examples when applicable. | ||
| Spark SQL is Apache Spark's module for working with structured data. The SQL Syntax section describes the SQL syntax in detail along with usage examples when applicable. This document provides a list of Data Definition and Data Manipulation Statements, as well as Data Retrieval and Auxiliary Statements. | ||
|
|
||
| ### Data Definition Statements |
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.
How about DDL Statements for consistency? https://github.com/apache/spark/blob/master/docs/sql-migration-guide.md#ddl-statements
docs/sql-ref-syntax.md
Outdated
| - [TRUNCATE TABLE](sql-ref-syntax-ddl-truncate-table.html) | ||
| - [USE DATABASE](sql-ref-syntax-qry-select-usedb.html) | ||
|
|
||
| ### Data Manipulation Statements |
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.
ditto: DML Statements?
| - [LIMIT Clause](sql-ref-syntax-qry-select-limit.html) | ||
| - [ORDER BY Clause](sql-ref-syntax-qry-select-orderby.html) | ||
| - [SORT BY Clause](sql-ref-syntax-qry-select-sortby.html) | ||
| - [WHERE Clause](sql-ref-syntax-qry-select-where.html) |
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.
We need these links to the sub-categoris of SELECT? Just linking to sql-ref-syntax-qry-select.md here is not enough?
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.
Thanks for your comment. I want to list all the sql statements on one page, so I prefer to have all the links here.
|
Test build #120624 has finished for PR 28074 at commit
|
|
@srowen This is for 3.0. Thank you! |
…ence ### What changes were proposed in this pull request? Add a page to list all commands in SQL Reference... ### Why are the changes needed? so it's easier for user to find a specific command. ### Does this PR introduce any user-facing change? before:  after:   Also move ```use database``` from query category to ddl category. ### How was this patch tested? Manually build and check Closes #28074 from huaxingao/list-all. Authored-by: Huaxin Gao <[email protected]> Signed-off-by: Takeshi Yamamuro <[email protected]> (cherry picked from commit 1a7f964) Signed-off-by: Takeshi Yamamuro <[email protected]>
|
Thanks, @huaxingao ! Merged to master/3.0. btw, have we done all the works about the SQL references? It seems the RC1 for 3.0 will be started in a few days. |
|
Thanks! @maropu @srowen |
|
ok, thanks for the work! cc: @dongjoon-hyun |
…ence ### What changes were proposed in this pull request? Add a page to list all commands in SQL Reference... ### Why are the changes needed? so it's easier for user to find a specific command. ### Does this PR introduce any user-facing change? before:  after:   Also move ```use database``` from query category to ddl category. ### How was this patch tested? Manually build and check Closes apache#28074 from huaxingao/list-all. Authored-by: Huaxin Gao <[email protected]> Signed-off-by: Takeshi Yamamuro <[email protected]>
What changes were proposed in this pull request?
Add a page to list all commands in SQL Reference...
Why are the changes needed?
so it's easier for user to find a specific command.
Does this PR introduce any user-facing change?
before:

after:

Also move
use databasefrom query category to ddl category.How was this patch tested?
Manually build and check