Skip to content
67 changes: 66 additions & 1 deletion docs/sql-ref-syntax-ddl-drop-table.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
<dl>
<dt><code><em>IF EXISTS</em></code></dt>
<dd>
If specified, no exception is thrown when the table does not exists.
</dd>
<dt><code><em>database_name</em></code></dt>
<dd>
Specifies the database name where table is present.
</dd>
<dt><code><em>table_name</em></code></dt>
<dd>
Specifies the table name to be dropped.
</dd>
</dl>

### 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)


61 changes: 60 additions & 1 deletion docs/sql-ref-syntax-ddl-drop-view.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
<dl>
<dt><code><em>IF EXISTS</em></code></dt>
<dd>
If specified, no exception is thrown when the view does not exists.
</dd>
<dt><code><em>database_name</em></code></dt>
<dd>
Specifies the database name where view is present.
</dd>
<dt><code><em>view_name</em></code></dt>
<dd>
Specifies the view name to be dropped.
</dd>
</dl>

### 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)