huaxingao commented on a change in pull request #27216: [SPARK-28801][DOC]
Document SELECT statement in SQL Reference (Main page)
URL: https://github.com/apache/spark/pull/27216#discussion_r368373476
##########
File path: docs/sql-ref-syntax-qry-select.md
##########
@@ -18,8 +18,119 @@ license: |
See the License for the specific language governing permissions and
limitations under the License.
---
+Spark supports a `SELECT` statement and conforms to the ANSI SQL standard.
Queries are
+used to retrieve result sets from one or more tables. The following section
+describes the overall query syntax and the sub-sections cover different
constructs
+of a query along with examples.
-Spark SQL is a Apache Spark's module for working with structured data.
-This guide is a reference for Structured Query Language (SQL) for Apache
-Spark. This document describes the SQL constructs supported by Spark in detail
-along with usage examples when applicable.
+### Syntax
+{% highlight sql %}
+[WITH with_query [, ...]]
Review comment:
I guess always have a space between symbol and text, and between symbol and
symbol?
```
[ WITH with_query [ , ... ] ]
```
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
With regards,
Apache Git Services
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
