动态表

动态表 DDL 命令用于创建、修改、查询和删除基于 SQL 查询自动增量刷新的动态表对象。

本章内容

页面	说明
动态表简介	动态表的工作原理与增量刷新机制
CREATE DYNAMIC TABLE	创建动态表，指定刷新间隔和定义 SQL
ALTER DYNAMIC TABLE	修改刷新间隔、暂停/恢复刷新、重命名
DYNAMIC TABLE DML	动态表支持的 DML 操作（部分场景下允许直接写入）
DROP DYNAMIC TABLE	删除动态表及其数据
RESTORE DYNAMIC TABLE	将动态表回滚到某个历史版本
UNDROP DYNAMIC TABLE	恢复已删除的动态表（在数据保留期内）
DESC DYNAMIC TABLE	查看动态表的列定义和刷新状态
DESC HISTORY DYNAMIC TABLE	查看动态表的历史版本列表
SHOW DYNAMIC TABLES	列出当前 Schema 下的所有动态表
SHOW CREATE DYNAMIC TABLE	查看创建动态表的完整语句
SHOW DYNAMIC TABLE REFRESH HISTORY	查看动态表的刷新历史，监控刷新状态和耗时

常用操作

创建动态表

-- 基础动态表（每 10 分钟刷新） CREATE OR REPLACE DYNAMIC TABLE public.dws_category_sales REFRESH INTERVAL 10 MINUTE VCLUSTER DEFAULT AS SELECT p.category, COUNT(*) AS order_cnt, SUM(o.quantity) AS total_quantity FROM public.orders o JOIN public.products p ON o.product_id = p.product_id GROUP BY p.category;

修改刷新配置

-- 修改刷新间隔 ALTER DYNAMIC TABLE public.dws_category_sales REFRESH INTERVAL 30 MINUTE; -- 暂停自动刷新 ALTER DYNAMIC TABLE public.dws_category_sales SUSPEND; -- 恢复自动刷新 ALTER DYNAMIC TABLE public.dws_category_sales RESUME;

手动刷新

-- 立即触发一次刷新 REFRESH DYNAMIC TABLE public.dws_category_sales;

查看与监控

-- 查看所有动态表 SHOW DYNAMIC TABLES; -- 查看动态表状态和刷新配置 DESC DYNAMIC TABLE public.dws_category_sales; -- 查看刷新历史（最近 10 次） SHOW DYNAMIC TABLE REFRESH HISTORY WHERE name = 'dws_category_sales' LIMIT 10;

删除与恢复

-- 删除动态表 DROP DYNAMIC TABLE IF EXISTS public.dws_category_sales; -- 恢复已删除的动态表 UNDROP DYNAMIC TABLE public.dws_category_sales;

文档	说明
SQL 命令总览	所有 SQL 命令分类导航
动态表（对象模型）	动态表的心智模型、增量刷新原理和数据管道构建
Table Stream	捕获动态表的变更用于下游消费

动态表