diff --git a/docs/sql-ref-syntax-ddl-drop-database.md b/docs/sql-ref-syntax-ddl-drop-database.md index cd900a7e393d..f3cdbf91a8d2 100644 --- a/docs/sql-ref-syntax-ddl-drop-database.md +++ b/docs/sql-ref-syntax-ddl-drop-database.md @@ -19,4 +19,62 @@ license: | limitations under the License. --- -**This page is under construction** +### Description + +Drop a database and delete the directory associated with the database from the file system. An +exception will be thrown if the database does not exist in the system. + +### Syntax + +{% highlight sql %} +DROP (DATABASE|SCHEMA) [IF EXISTS] dbname [RESTRICT|CASCADE]; +{% endhighlight %} + + +### Parameters + +
+
DATABASE|SCHEMA
+
`DATABASE` and `SCHEMA` mean the same thing, either of them can be used.
+
+ +
+
IF EXISTS
+
If specified, no exception is thrown when the database does not exist.
+
+ +
+
RESTRICT
+
If specified, will restrict dropping a non-empty database and is enabled by default.
+
+ +
+
CASCADE
+
If specified, will drop all the associated tables and functions.
+
+ +### Example +{% highlight sql %} +-- Create `inventory_db` Database +CREATE DATABASE inventory_db COMMENT 'This database is used to maintain Inventory'; + +-- Drop the database and it's tables +DROP DATABASE inventory_db CASCADE; ++---------+ +| Result | ++---------+ ++---------+ + +-- Drop the database using IF EXISTS +DROP DATABASE IF EXISTS inventory_db CASCADE; ++---------+ +| Result | ++---------+ ++---------+ + +{% endhighlight %} + +### Related statements +- [CREATE DATABASE](sql-ref-syntax-ddl-create-database.html) +- [DESCRIBE DATABASE](sql-ref-syntax-aux-describe-database.html) +- [SHOW DATABASES](sql-ref-syntax-aux-show-databases.html) \ No newline at end of file