> For the complete documentation index, see [llms.txt](https://upsolver.gitbook.io/content/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://upsolver.gitbook.io/content/reference-1/sql-commands/iceberg-tables/upsolver-managed-tables/drop-iceberg-table.md).

# DROP ICEBERG TABLE

This command deletes the specified Apache Iceberg table.

Note that if existing jobs are dependent upon the table in question, then the table cannot be dropped.

## Syntax

```sql
DROP ICEBERG TABLE [ IF EXISTS ] <table_identifier> 
    DELETE_DATA = { TRUE | FALSE }
    [ COMPUTE_CLUSTER = <cluster_identifier> ];
```

#### `DELETE_DATA`

Type: `Boolean`

When `false`, only the table's metadata is deleted while the data itself is retained in S3.

#### `COMPUTE_CLUSTER`

Type: `identifier`

Default: The sole cluster in your environment

(Optional) The cluster that processes the deletion.

This option can only be omitted when there is just one cluster in your environment. You must specify which one to use when you have more than one compute cluster.

#### `IF EXISTS`

(Optional) To prevent the Upsolver query engine from returning an error if the table does not exist, include `IF EXISTS` in your `DROP` statement; instead, you will see the message **Operation resulted in no change**.

***

## Example

The following example runs a `DROP` statement with `IF EXISTS` to drop the table, **my\_test\_table**. By including `IF EXISTS`, an error is not encountered if the table does not exist. Otherwise, if the table exists, it will be dropped from the organization:&#x20;

```sql
DROP ICEBERG TABLE IF EXISTS "my_test_table" DELETE_DATA = FALSE;
```

The `DELETE_DATA` option is set to **FALSE**, so only the metadata is deleted, and the data is retained.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://upsolver.gitbook.io/content/reference-1/sql-commands/iceberg-tables/upsolver-managed-tables/drop-iceberg-table.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.