删除动态表(DROP DYNAMIC TABLE)

功能概述

DROP DYNAMIC TABLE
DROP DYNAMIC TABLE
命令用于删除已存在的动态表(Dynamic Table)。

动态表是一种基于查询定义自动增量刷新的数据对象,它根据源表的变更数据定期刷新结果。当你不再需要某个动态表时,可以使用本命令将其删除。

语法

DROP DYNAMIC TABLE [ IF EXISTS ] [schema_name.]<dt_name>

参数说明

参数是否必填说明
IF EXISTS
IF EXISTS
如果指定的动态表不存在,系统不会报错,静默跳过
schema_name
schema_name
指定 schema 的名称。如果未指定,默认使用当前 schema
dt_name
dt_name
要删除的动态表名称

使用示例

示例 1:删除动态表

DROP DYNAMIC TABLE sales_summary;

示例 2:安全删除(表不存在时不报错)

DROP DYNAMIC TABLE IF EXISTS sales_summary;

示例 3:删除指定 schema 下的动态表

DROP DYNAMIC TABLE IF EXISTS analytics.daily_report;

示例 4:删除后恢复

-- 删除动态表 DROP DYNAMIC TABLE analytics.daily_report; -- 恢复动态表(注意:使用 UNDROP TABLE,不是 UNDROP DYNAMIC TABLE) UNDROP TABLE analytics.daily_report;

注意事项

  • 必须使用正确的 DROP 命令:删除动态表必须使用

    DROP DYNAMIC TABLE
    DROP DYNAMIC TABLE
    ,使用
    DROP TABLE
    DROP TABLE
    会报错:

    The operation 'DROP TABLE' requires a 'TABLE'. But 'xxx' is a DYNAMIC TABLE, please use 'DROP DYNAMIC TABLE' instead.

  • 数据可恢复:删除动态表并非不可逆。在

    data_retention_days
    data_retention_days
    保留周期内(默认 1 天,最长可配置为 90 天),可通过
    UNDROP TABLE
    UNDROP TABLE
    恢复。恢复后动态表仍保持其动态表属性(增量刷新配置等)。

  • 同名冲突处理:如果删除后创建了同名新表,需先重命名或删除新表,才能恢复旧表:

    ALTER TABLE daily_report RENAME TO daily_report_backup; UNDROP TABLE daily_report;

  • 下游影响:删除动态表前,请确认是否有其他动态表或查询依赖它。被删除的动态表如果作为其他动态表的源表,下游刷新将失败。

相关命令

联系我们
预约咨询
微信咨询
电话咨询
邮件咨询