diff --git a/docs/sql-ref-syntax-ddl-drop-table.md b/docs/sql-ref-syntax-ddl-drop-table.md index a036e66c3906..f9129d5114fa 100644 --- a/docs/sql-ref-syntax-ddl-drop-table.md +++ b/docs/sql-ref-syntax-ddl-drop-table.md @@ -19,4 +19,69 @@ license: | limitations under the License. --- -**This page is under construction** +### Description + +`DROP TABLE` deletes the table and removes the directory associated with the table from the file system +if the table is not `EXTERNAL` table. If the table is not present it throws an exception. + +In case of an external table, only the associated metadata information is removed from the metastore database. + +### Syntax +{% highlight sql %} +DROP TABLE [IF EXISTS] [database_name.]table_name +{% endhighlight %} + +### Parameter +
+
IF EXISTS
+
+ If specified, no exception is thrown when the table does not exists. +
+
database_name
+
+ Specifies the database name where table is present. +
+
table_name
+
+ Specifies the table name to be dropped. +
+
+ +### Example +{% highlight sql %} +-- Assumes a table named `employeetable` exists. +DROP TABLE employeetable; ++---------+--+ +| Result | ++---------+--+ ++---------+--+ + +-- Assumes a table named `employeetable` exists in the `userdb` database +DROP TABLE userdb.employeetable; ++---------+--+ +| Result | ++---------+--+ ++---------+--+ + +-- Assumes a table named `employeetable` does not exists. +-- Throws exception +DROP TABLE employeetable; +Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeetable; +(state=,code=0) + +-- Assumes a table named `employeetable` does not exists,Try with IF EXISTS +-- this time it will not throw exception +DROP TABLE IF EXISTS employeetable; ++---------+--+ +| Result | ++---------+--+ ++---------+--+ + +{% endhighlight %} + +### Related Statements +- [CREATE TABLE](sql-ref-syntax-ddl-create-table.html) +- [CREATE DATABASE](sql-ref-syntax-ddl-create-database.html) +- [DROP DATABASE](sql-ref-syntax-ddl-drop-database.html) + + diff --git a/docs/sql-ref-syntax-ddl-drop-view.md b/docs/sql-ref-syntax-ddl-drop-view.md index 9ad22500fd9e..f095a3456772 100644 --- a/docs/sql-ref-syntax-ddl-drop-view.md +++ b/docs/sql-ref-syntax-ddl-drop-view.md @@ -19,4 +19,63 @@ license: | limitations under the License. --- -**This page is under construction** +### Description +`DROP VIEW` removes the metadata associated with a specified view from the catalog. + +### Syntax +{% highlight sql %} +DROP VIEW [IF EXISTS] [database_name.]view_name +{% endhighlight %} + +### Parameter +
+
IF EXISTS
+
+ If specified, no exception is thrown when the view does not exists. +
+
database_name
+
+ Specifies the database name where view is present. +
+
view_name
+
+ Specifies the view name to be dropped. +
+
+ +### Example +{% highlight sql %} +-- Assumes a view named `employeeView` exists. +DROP VIEW employeeView; ++---------+--+ +| Result | ++---------+--+ ++---------+--+ + +-- Assumes a view named `employeeView` exists in the `userdb` database +DROP VIEW userdb.employeeView; ++---------+--+ +| Result | ++---------+--+ ++---------+--+ + +-- Assumes a view named `employeeView` does not exists. +-- Throws exception +DROP VIEW employeeView; +Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeeView; +(state=,code=0) + +-- Assumes a view named `employeeView` does not exists,Try with IF EXISTS +-- this time it will not throw exception +DROP VIEW IF EXISTS employeeView; ++---------+--+ +| Result | ++---------+--+ ++---------+--+ + +{% endhighlight %} + +### Related Statements +- [CREATE VIEW](sql-ref-syntax-ddl-create-view.html) +- [CREATE DATABASE](sql-ref-syntax-ddl-create-database.html) +- [DROP DATABASE](sql-ref-syntax-ddl-drop-database.html)