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

Deletes the table and removes the directory associated with this table from the file system
if this is not `EXTERNAL` table. If the table is not present it throws an exception.

In case of External table, only the associated metadata information are removed from the metastore database.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

of an external table


### 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 exist.
</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 name `employeetable` exist.
DROP TABLE employeetable;
+---------+--+
| Result |
+---------+--+
+---------+--+

-- Assumes a table name `employeetable` exist in `userdb` database
DROP TABLE userdb.employeetable;
+---------+--+
| Result |
+---------+--+
+---------+--+

-- Assumes a table name `employeetable` does not exist.
-- Throws exception
DROP TABLE employeetable;
Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeetable;
(state=,code=0)

-- Assumes a table name `employeetable` does not exist,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 exist.
</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 name `employeeView` exist.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

exists

DROP VIEW employeeView;
+---------+--+
| Result |
+---------+--+
+---------+--+

-- Assumes a view name `employeeView` exist in `userdb` database
DROP VIEW userdb.employeeView;
+---------+--+
| Result |
+---------+--+
+---------+--+

-- Assumes a view name `employeeView` does not exist.
-- Throws exception
DROP VIEW employeeView;
Error: org.apache.spark.sql.AnalysisException: Table or view not found: employeeView;
(state=,code=0)

-- Assumes a view name `employeeView` does not exist,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)