LakshSingla commented on code in PR #16843:
URL: https://github.com/apache/druid/pull/16843#discussion_r1714046446


##########
docs/querying/sql.md:
##########
@@ -423,3 +423,17 @@ SELECT count(city) from druid.table where 
SCALAR_IN_ARRAY(city, ?)
 ```
 
 sample java code using dynamic parameters is provided 
[here](../api-reference/sql-jdbc.md#dynamic-parameters).
+
+## Reserved keywords
+
+Druid SQL reserves certain keywords which are used in its query language. 
Apache Druid inherits all of the reserved keywords from [Apache 
Calcite](https://calcite.apache.org/docs/reference.html#keywords), in addition 
to these the following keywords unique to Apache Druid and are also reserved:

Review Comment:
   ```suggestion
   Druid SQL reserves certain keywords which are used in its query language. 
Apache Druid inherits all of the reserved keywords from [Apache 
Calcite](https://calcite.apache.org/docs/reference.html#keywords). In addition 
to these, the following reserved keywords are unique to Apache Druid: ```



##########
docs/querying/sql.md:
##########
@@ -423,3 +423,17 @@ SELECT count(city) from druid.table where 
SCALAR_IN_ARRAY(city, ?)
 ```
 
 sample java code using dynamic parameters is provided 
[here](../api-reference/sql-jdbc.md#dynamic-parameters).
+
+## Reserved keywords
+
+Druid SQL reserves certain keywords which are used in its query language. 
Apache Druid inherits all of the reserved keywords from [Apache 
Calcite](https://calcite.apache.org/docs/reference.html#keywords), in addition 
to these the following keywords unique to Apache Druid and are also reserved:
+
+* **CLUSTERED**
+* **PARTITIONED**
+
+To use reserved keywords in queries, enclose them in quotation marks, for 
example the reserved keyword **CYCLE** can be used in the following query only 
if correct quoted:

Review Comment:
   ```suggestion
   To use the reserved keywords in queries, enclose them in double quotation 
marks. For example, the reserved keyword **PARTITIONED** can be used in a query 
if and only if it is correctly quoted:
   ```



##########
docs/querying/sql.md:
##########
@@ -423,3 +423,17 @@ SELECT count(city) from druid.table where 
SCALAR_IN_ARRAY(city, ?)
 ```
 
 sample java code using dynamic parameters is provided 
[here](../api-reference/sql-jdbc.md#dynamic-parameters).
+
+## Reserved keywords
+
+Druid SQL reserves certain keywords which are used in its query language. 
Apache Druid inherits all of the reserved keywords from [Apache 
Calcite](https://calcite.apache.org/docs/reference.html#keywords), in addition 
to these the following keywords unique to Apache Druid and are also reserved:
+
+* **CLUSTERED**
+* **PARTITIONED**
+
+To use reserved keywords in queries, enclose them in quotation marks, for 
example the reserved keyword **CYCLE** can be used in the following query only 
if correct quoted:

Review Comment:
   nit: It would be better to use either `CLUSTERED` or `PARTITIONED` in the 
example. 



-- 
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.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to