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 this table from the file system
Comment thread
shivusondur marked this conversation as resolved.
Outdated
if this 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 are removed from the metastore database.
Comment thread
shivusondur marked this conversation as resolved.
Outdated

### 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 |
Comment thread
shivusondur marked this conversation as resolved.
+---------+--+
+---------+--+

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