SHOW CREATE TABLE(动态表)

功能概述

查看动态表的完整创建语句,包含列定义、刷新调度、存储格式、注释和内部属性。适合在修改动态表前了解当前配置,或在迁移/恢复时重建定义。

语法

SHOW CREATE TABLE <table_name>;

参数说明

<table_name>
<table_name>
:动态表的全名或当前 Schema 下的表名。支持三段式(
<workspace>.<schema>.<table>
<workspace>.<schema>.<table>
)、两段式(
<schema>.<table>
<schema>.<table>
)或单段式(
<table>
<table>
,使用当前 Schema)。

使用示例

创建一张带注释的动态表:

CREATE TABLE quick_test_base (id INT, val INT); INSERT INTO quick_test_base VALUES (1, 10), (2, 20); CREATE DYNAMIC TABLE quick_test_alter REFRESH INTERVAL '10' MINUTE USING PARQUET COMMENT '测试注释' AS SELECT id, val AS val2 FROM quick_test_base;

查看其创建语句:

SHOW CREATE TABLE quick_test_alter;

返回结果(

sql
sql
列):

CREATE DYNAMIC TABLE quick_start.semantic_model_test.quick_test_alter( `id` int, `val2` int) REFRESH START WITH TIMESTAMP '2026-06-13 07:37:49.557' INTERVAL '10' MINUTE USING PARQUET COMMENT '测试注释' TBLPROPERTIES( 'cz.compaction.server.multi.sql.job'='false', 'cz.compaction.strategy'='dml', 'cz.sql.incremental.refresh.interval.derived.compaction.strategy'='AUTO') AS SELECT id, val FROM quick_test_base;

输出字段说明

字段 / 子句含义
列定义(
id int
id int
等)
动态表的输出列名和类型,由查询语句推导
REFRESH START WITH TIMESTAMP
REFRESH START WITH TIMESTAMP
系统记录的动态表首次创建时间,用于增量计算起点;自动生成,无需手动指定
INTERVAL '10' MINUTE
INTERVAL '10' MINUTE
调度刷新间隔,创建时通过
REFRESH INTERVAL
REFRESH INTERVAL
指定
USING PARQUET
USING PARQUET
底层存储格式
COMMENT
COMMENT
建表时通过
COMMENT
COMMENT
子句设置的注释
TBLPROPERTIES
TBLPROPERTIES
系统内部参数,见下方注意事项
AS ...
AS ...
定义动态表的查询语句

注意事项

  • TBLPROPERTIES
    TBLPROPERTIES
    中的参数(如
    cz.compaction.strategy
    cz.compaction.strategy
    cz.sql.incremental.refresh.interval.derived.compaction.strategy
    cz.sql.incremental.refresh.interval.derived.compaction.strategy
    )是系统在创建时自动生成的内部配置,不需要手动设置,也不建议在重建语句时直接复制使用。
  • REFRESH START WITH TIMESTAMP
    REFRESH START WITH TIMESTAMP
    是系统在首次创建时自动记录的起始时间戳,代表增量计算的基准点。如果你用该输出重建动态表,去掉此子句即可,系统会以重建时间为新起点。
  • 该命令同样适用于普通表、外部表、物化视图和视图,返回对应的 DDL。

相关文档

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