DROP 命令参考

功能概述

删除云器 Lakehouse 中的各类 Lakehouse 对象。

DROP <object_type> [ IF EXISTS ] <identifier>

参数说明是否必填

参数	说明	是否必填
`<object_type>` <object_type>	要删除的对象类型，如 `TABLE` TABLE 、 `DYNAMIC TABLE` DYNAMIC TABLE 、 `VIEW` VIEW 等	是
`IF EXISTS` IF EXISTS	对象不存在时静默跳过，不报错	否
`<identifier>` <identifier>	对象名称，可包含 schema 前缀	是

<object_type>

<object_type>

要删除的对象类型，如

TABLE

TABLE

、

DYNAMIC TABLE

DYNAMIC TABLE

、

VIEW

VIEW

等

是

IF EXISTS

IF EXISTS

对象不存在时静默跳过，不报错

否

<identifier>

对象名称，可包含 schema 前缀

是

对象类型	删除语法	可恢复	恢复语法
普通表	`DROP TABLE <name>` DROP TABLE <name>	✅	`UNDROP TABLE <name>` UNDROP TABLE <name>
动态表	`DROP DYNAMIC TABLE <name>` DROP DYNAMIC TABLE <name>	✅	`UNDROP TABLE <name>` UNDROP TABLE <name>
物化视图	`DROP MATERIALIZED VIEW <name>` DROP MATERIALIZED VIEW <name>	✅	`UNDROP TABLE <name>` UNDROP TABLE <name>
Table Stream	`DROP TABLE STREAM <name>` DROP TABLE STREAM <name>	✅	`UNDROP TABLE <name>` UNDROP TABLE <name>
视图	`DROP VIEW <name>` DROP VIEW <name>	❌	—
外部表	`DROP EXTERNAL TABLE <name>` DROP EXTERNAL TABLE <name>	❌	—
Schema	`DROP SCHEMA <name>` DROP SCHEMA <name>	❌	—
外部 Schema	`DROP EXTERNAL SCHEMA <name>` DROP EXTERNAL SCHEMA <name>	❌	—
计算集群	`DROP VCLUSTER <name>` DROP VCLUSTER <name>	❌	—
连接	`DROP CONNECTION <name>` DROP CONNECTION <name>	❌	—
数据分享	`DROP SHARE <name>` DROP SHARE <name>	❌	—
索引	`DROP INDEX <name>` DROP INDEX <name>	❌	—
函数	`DROP FUNCTION <name>` DROP FUNCTION <name>	❌	—
外部函数	`DROP EXTERNAL FUNCTION <name>` DROP EXTERNAL FUNCTION <name>	❌	—
同义词	`DROP SYNONYM <name>` DROP SYNONYM <name>	❌	—
用户	`DROP USER <name>` DROP USER <name>	❌	—
角色	`DROP ROLE <name>` DROP ROLE <name>	❌	—

执行

DROP

DROP

操作需要满足以下权限之一：

对象类型必须匹配：删除动态表必须使用
```
DROP DYNAMIC TABLE
```
DROP DYNAMIC TABLE
，删除物化视图必须使用
```
DROP MATERIALIZED VIEW
```
DROP MATERIALIZED VIEW
，使用错误的类型会报错
数据可恢复：普通表、动态表、物化视图、Table Stream 在 Time Travel 保留周期内可通过
```
UNDROP TABLE
```
UNDROP TABLE
恢复
级联删除：
```
DROP SCHEMA
```
DROP SCHEMA
会级联删除该 Schema 下的所有对象，无需额外指定
```
CASCADE
```
CASCADE
依赖检查：删除表前请检查是否有视图、动态表、Table Stream 或 ETL 任务依赖该对象