huaxingao commented on a change in pull request #25595: [SPARK-28792][SQL][DOC]
Document CREATE DATABASE statement in SQL Reference.
URL: https://github.com/apache/spark/pull/25595#discussion_r319601458
##########
File path: docs/sql-ref-syntax-ddl-create-database.md
##########
@@ -19,4 +19,39 @@ license: |
limitations under the License.
---
-**This page is under construction**
+### Description
+Creates a database with the given name. If database with the same name exists
an exception will be thrown.
+
+### Syntax
+{% highlight sql %}
+CREATE (DATABASE|SCHEMA) [IF NOT EXISTS] database_name
+ [COMMENT database_comment]
+ [LOCATION database_directory]
+ [WITH DBPROPERTIES (property_name=property_value, ...)]
Review comment:
@dilipbiswal @gatorsmile
I am wondering if we should define a standard for the syntax format. Should
we have a white space between the braces, =, |, ... and the text? I currently
put a white space because I saw a couple of sql references have these standard.
I am OK with either having white space or no white space, but I am thinking we
may need to define a standard and write out the standard explicitly in the
umbrella jira so everybody can follow. Also, shall we have 4 white space
indentation for the 2nd line? I am ok with either 2 or 4, but prefer everybody
to follow the same way.
----------------------------------------------------------------
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]
