From 083d4794f06d57db8b82eb0012e37885dd7357a3 Mon Sep 17 00:00:00 2001 From: Huaxin Gao Date: Mon, 30 Mar 2020 09:33:00 -0700 Subject: [PATCH 1/3] [SPARK-31305][SQL][DOCS] Add a page to list all commands in SQL Reference --- docs/sql-ref-syntax.md | 62 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 61 insertions(+), 1 deletion(-) diff --git a/docs/sql-ref-syntax.md b/docs/sql-ref-syntax.md index 2510278ab252..0fe4cb2653e5 100644 --- a/docs/sql-ref-syntax.md +++ b/docs/sql-ref-syntax.md @@ -19,4 +19,64 @@ license: | limitations under the License. --- -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 +- [ALTER DATABASE](sql-ref-syntax-ddl-alter-database.html) +- [ALTER TABLE](sql-ref-syntax-ddl-alter-table.html) +- [ALTER VIEW](sql-ref-syntax-ddl-alter-view.html) +- [CREATE DATABASE](sql-ref-syntax-ddl-create-database.html) +- [CREATE FUNCTION](sql-ref-syntax-ddl-create-function.html) +- [CREATE TABLE](sql-ref-syntax-ddl-create-table.html) +- [CREATE VIEW](sql-ref-syntax-ddl-create-view.html) +- [DROP DATABASE](sql-ref-syntax-ddl-drop-database.html) +- [DROP FUNCTION](sql-ref-syntax-ddl-drop-function.html) +- [DROP TABLE](sql-ref-syntax-ddl-drop-table.html) +- [DROP VIEW](sql-ref-syntax-ddl-drop-view.html) +- [REPAIR TABLE](sql-ref-syntax-ddl-repair-table.html) +- [TRUNCATE TABLE](sql-ref-syntax-ddl-truncate-table.html) +- [USE DATABASE](sql-ref-syntax-qry-select-usedb.html) + +### Data Manipulation Statements +- [INSERT INTO](sql-ref-syntax-dml-insert-into.html) +- [INSERT OVERWRITE](sql-ref-syntax-dml-insert-overwrite-table.html) +- [INSERT OVERWRITE DIRECTORY](sql-ref-syntax-dml-insert-overwrite-directory.html) +- [INSERT OVERWRITE DIRECTORY with Hive format](sql-ref-syntax-dml-insert-overwrite-directory-hive.html) +- [LOAD](sql-ref-syntax-dml-load.html) + +### Data Retrieval Statements +- [CLUSTER BY Clause](sql-ref-syntax-qry-select-clusterby.html) +- [DISTRIBUTE BY Clause](sql-ref-syntax-qry-select-distribute-by.html) +- [EXPLAIN](sql-ref-syntax-qry-explain.html) +- [GROUP BY Clause](sql-ref-syntax-qry-select-groupby.html) +- [HAVING Clause](sql-ref-syntax-qry-select-having.html) +- [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) + +### Auxiliary Statements +- [ADD FILE](sql-ref-syntax-aux-resource-mgmt-add-file.html) +- [ADD JAR](sql-ref-syntax-aux-resource-mgmt-add-jar.html) +- [ANALYZE TABLE](sql-ref-syntax-aux-analyze-table.html) +- [CACHE TABLE](sql-ref-syntax-aux-cache-cache-table.html) +- [CLEAR CACHE](sql-ref-syntax-aux-cache-clear-cache.html) +- [DESCRIBE DATABASE](sql-ref-syntax-aux-describe-database.html) +- [DESCRIBE FUNCTION](sql-ref-syntax-aux-describe-function.html) +- [DESCRIBE QUERY](sql-ref-syntax-aux-describe-query.html) +- [DESCRIBE TABLE](sql-ref-syntax-aux-describe-table.html) +- [LIST FILE](sql-ref-syntax-aux-resource-mgmt-list-file.html) +- [LIST JAR](sql-ref-syntax-aux-resource-mgmt-list-jar.html) +- [REFRESH](sql-ref-syntax-aux-cache-refresh.html) +- [REFRESH TABLE](sql-ref-syntax-aux-refresh-table.html) +- [SET](sql-ref-syntax-aux-conf-mgmt-set.html) +- [SHOW COLUMNS](sql-ref-syntax-aux-show-columns.html) +- [SHOW CREATE TABLE](sql-ref-syntax-aux-show-create-table.html) +- [SHOW DATABASES](sql-ref-syntax-aux-show-databases.html) +- [SHOW FUNCTIONS](sql-ref-syntax-aux-show-functions.html) +- [SHOW PARTITIONS](sql-ref-syntax-aux-show-partitions.html) +- [SHOW TABLE EXTENDED](sql-ref-syntax-aux-show-table.html) +- [SHOW TABLES](sql-ref-syntax-aux-show-tables.html) +- [SHOW TBLPROPERTIES](sql-ref-syntax-aux-show-tblproperties.html) +- [UNCACHE TABLE](sql-ref-syntax-aux-cache-uncache-table.html) +- [UNSET](sql-ref-syntax-aux-conf-mgmt-reset.html) From 571765a161b0580cd2bff3fdac7780292ed785ea Mon Sep 17 00:00:00 2001 From: Huaxin Gao Date: Mon, 30 Mar 2020 10:03:05 -0700 Subject: [PATCH 2/3] move use database to ddl --- docs/_data/menu-sql.yaml | 4 ++-- docs/sql-ref-syntax-ddl.md | 1 + 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/_data/menu-sql.yaml b/docs/_data/menu-sql.yaml index 8a1d9374fba8..f8e9bc83998a 100644 --- a/docs/_data/menu-sql.yaml +++ b/docs/_data/menu-sql.yaml @@ -123,6 +123,8 @@ url: sql-ref-syntax-ddl-truncate-table.html - text: REPAIR TABLE url: sql-ref-syntax-ddl-repair-table.html + - text: USE DATABASE + url: sql-ref-syntax-qry-select-usedb.html - text: Data Manipulation Statements url: sql-ref-syntax-dml.html subitems: @@ -152,8 +154,6 @@ url: sql-ref-syntax-qry-select-distribute-by.html - text: LIMIT Clause url: sql-ref-syntax-qry-select-limit.html - - text: USE database - url: sql-ref-syntax-qry-select-usedb.html - text: EXPLAIN url: sql-ref-syntax-qry-explain.html - text: Auxiliary Statements diff --git a/docs/sql-ref-syntax-ddl.md b/docs/sql-ref-syntax-ddl.md index 954020a87445..ab4e95a1539f 100644 --- a/docs/sql-ref-syntax-ddl.md +++ b/docs/sql-ref-syntax-ddl.md @@ -36,3 +36,4 @@ Data Definition Statements are used to create or modify the structure of databas - [DROP VIEW](sql-ref-syntax-ddl-drop-view.html) - [TRUNCATE TABLE](sql-ref-syntax-ddl-truncate-table.html) - [REPAIR TABLE](sql-ref-syntax-ddl-repair-table.html) +- [USE DATABASE](sql-ref-syntax-qry-select-usedb.html) From c8c9f177743a55d911cb16d5e60e7ce94f8cac0f Mon Sep 17 00:00:00 2001 From: Huaxin Gao Date: Mon, 30 Mar 2020 19:07:31 -0700 Subject: [PATCH 3/3] address comments --- docs/sql-ref-syntax.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/sql-ref-syntax.md b/docs/sql-ref-syntax.md index 0fe4cb2653e5..3db97ac11dd8 100644 --- a/docs/sql-ref-syntax.md +++ b/docs/sql-ref-syntax.md @@ -21,7 +21,7 @@ license: | 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 +### DDL Statements - [ALTER DATABASE](sql-ref-syntax-ddl-alter-database.html) - [ALTER TABLE](sql-ref-syntax-ddl-alter-table.html) - [ALTER VIEW](sql-ref-syntax-ddl-alter-view.html) @@ -37,7 +37,7 @@ Spark SQL is Apache Spark's module for working with structured data. The SQL Syn - [TRUNCATE TABLE](sql-ref-syntax-ddl-truncate-table.html) - [USE DATABASE](sql-ref-syntax-qry-select-usedb.html) -### Data Manipulation Statements +### DML Statements - [INSERT INTO](sql-ref-syntax-dml-insert-into.html) - [INSERT OVERWRITE](sql-ref-syntax-dml-insert-overwrite-table.html) - [INSERT OVERWRITE DIRECTORY](sql-ref-syntax-dml-insert-overwrite-directory.html)