Merge pull request #10629 from BohuTANG/doc-select

docs(query): add query syntax index

Author: BohuTANG

docs/doc/14-sql-commands/20-query-syntax/01-dml-select.md

@@ -7,23 +7,22 @@ Retrieves data from a table.
 ## Syntax
 
 ```sql
+[WITH]
 SELECT
     [ALL | DISTINCT]
-    select_expr [[AS] alias], ...
-    [INTO variable [, ...]]
-    [EXCLUDE (col_name1 [, col_name2, col_name3, ...] ) ]
+    <select_expr> [[AS] alias], ...
+    [EXCLUDE (<col_name1> [, <col_name2>, <col_name3>, ...] ) ]
     [FROM table_references
     [AT ...]
-    [WHERE expr]
-    [GROUP BY {{col_name | expr | col_alias | col_position}, ...
-    | extended_grouping_expr}]
-    [HAVING expr]
-    [ORDER BY {col_name | expr | col_alias | col_position} [ASC | DESC], [ NULLS { FIRST | LAST }]
-    [LIMIT row_count]
-    [OFFSET row_count]
+    [WHERE <expr>]
+    [GROUP BY {{<col_name> | <expr> | <col_alias> | <col_position>}, 
+         ... | <extended_grouping_expr>}]
+    [HAVING <expr>]
+    [ORDER BY {<col_name> | <expr> | <col_alias> | <col_position>} [ASC | DESC],
+         [ NULLS { FIRST | LAST }]
+    [LIMIT <row_count>]
+    [OFFSET <row_count>]
     [IGNORE_RESULT]
-    ]
-    ]
 ```
 
 :::tip
@@ -43,7 +42,7 @@ SELECT number FROM numbers(3);
 +--------+
 ```
 
-### EXCLUDE Parameter
+## EXCLUDE Parameter
 
 Excludes one or more columns by their names from the result. The parameter is usually used in conjunction with `SELECT * ...` to exclude a few columns from the result instead of retrieving them all.
 

docs/doc/14-sql-commands/20-query-syntax/_category_.json

@@ -1,7 +1,3 @@
 {
-  "label": "Query Syntax",
-  "link": {
-    "type": "generated-index",
-    "slug": "/reference/sql/query-syntax"
-  }
+  "label": "Query Syntax"
 }

docs/doc/14-sql-commands/20-query-syntax/index.md

@@ -0,0 +1,25 @@
+---
+title: Query Syntax
+slug: ./
+---
+
+Databend supports querying using [SELECT](./01-dml-select.md) and the following basic syntax:
+
+```sql
+[WITH]
+SELECT
+    [ALL | DISTINCT]
+    <select_expr> [[AS] alias], ...
+    [EXCLUDE (<col_name1> [, <col_name2>, <col_name3>, ...] ) ]
+    [FROM table_references
+    [AT ...]
+    [WHERE <expr>]
+    [GROUP BY {{<col_name> | <expr> | <col_alias> | <col_position>}, 
+         ... | <extended_grouping_expr>}]
+    [HAVING <expr>]
+    [ORDER BY {<col_name> | <expr> | <col_alias> | <col_position>} [ASC | DESC],
+         [ NULLS { FIRST | LAST }]
+    [LIMIT <row_count>]
+    [OFFSET <row_count>]
+    [IGNORE_RESULT]
+```