dilipbiswal 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_r323589132
##########
File path: docs/sql-ref-syntax-ddl-create-database.md
##########
@@ -19,4 +19,58 @@ license: |
limitations under the License.
---
-**This page is under construction**
+### Description
+Creates a database with the specified name. If database with the same name
already 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
+<dl>
+ <dt><code><em>database_name</em></code></dt>
+ <dd>Specifies the name of the database to be created.</dd>
+
+ <dt><code><em>IF NOT EXISTS</em></code></dt>
+ <dd>Creates a database with the given name if it doesn't exists. If a
database with the same name already exists, nothing will happen.</dd>
+
+ <dt><code><em>database_directory</em></code></dt>
+ <dd>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. If location is not specified, database will
be created in default warehouse directory.</dd>
+
+ <dt><code><em>database_comment</em></code></dt>
+ <dd>Description for the database.</dd>
+
+ <dt><code><em>WITH DBPROPERTIES (property_name=property_value [ ,
...])</em></code></dt>
+ <dd>Properties for the database in key-value pair.</dd>
+</dl>
+
+### 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');
Review comment:
lets indent the 2nd line so that it looks continuation of first line like :
```
CREATE DATABASE IF NOT EXISTS customer_db COMMENT 'This is customer
database' LOCATION '/user'
WITH DBPROPERTIES (ID=001, Name='John');
```
----------------------------------------------------------------
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]
