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_r319593955
##########
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, ...)]
+
+{% endhighlight %}
+
+### Parameters
+- ##### ***IF NOT EXISTS***:
+Creates a database with the given name if it doesn't exists. If a database
with the same name already exists, nothing will happen.
+- ##### ***LOCATION***:
+Path of the file system in which database to be created. If the specified path
does not exist in the underlying file system, this command creates a directory
with the path.
+- ##### ***COMMENT***:
+Description for the Database.
+- ##### ***WITH DBPROPERTIES***:
+Properties for the database in key-value pair.
+
+### Examples
+{% highlight sql %}
+-- Create database `customer_db`. This throws exception if database with name
customer_db already exists.
+CREATE DATABASE customer_db;
+-- Create database `customer_db` only if database with same name doesn't exist.
+CREATE DATABASE IF NOT EXISTS customer_db;
+-- Create database `customer_db` only if database with same name doesn't exist
with `Comments`, `Specific Location` and `Database properties`.
+CREATE DATABASE IF NOT EXISTS customer_db COMMENT 'This is customer database'
LOCATION '/user' WITH DBPROPERTIES (ID=001, Name='John');
+{% endhighlight %}
+
+
+### Related statements.
Review comment:
nit: ### Related Statements
----------------------------------------------------------------
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]
