Skip to content
68 changes: 67 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,70 @@ 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 exception.
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: an exception


In case of External table it only deletes the metadata from metastore database and it will not remove the directory
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: In case of External table, only the associated metadata information are removed from the metastore database.

associated with this 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>
Database name where table is present.
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: Specifies the database name where table is present.

</dd>
<dt><code><em>table_name</em></code></dt>
<dd>
table name to be dropped.
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: Ditto.

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


62 changes: 61 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,64 @@ license: |
limitations under the License.
---

**This page is under construction**
### Description
Drops the specified `VIEW`, which was created by `CREATE VIEW` statement. `DROP VIEW` only involves
Copy link
Contributor

Choose a reason for hiding this comment

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

How about the following ?
DROP VIEW` removes the metadata associated with a specified view from the catalog.

changes in metadata from the metastore database.

### 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>
Database name where view is present.
Copy link
Contributor

Choose a reason for hiding this comment

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

Please add "Specifies"

</dd>
<dt><code><em>view_name</em></code></dt>
<dd>
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)