查看动态表结构（DESC DYNAMIC TABLE）
功能概述
DESC
DESC
命令用于查看动态表（Dynamic Table）的结构信息。默认仅返回列名、数据类型和注释；加上
EXTENDED
EXTENDED
关键字后可查看完整的表元数据，包括刷新配置、源表、查询定义等。
语法
DESC [TABLE] [EXTENDED] <dt_name>;
-- 或
DESCRIBE [TABLE] [EXTENDED] <dt_name>;
参数说明
| 参数 | 说明 |
|---|
DESC
DESC / DESCRIBE
DESCRIBE | 两者等价，可互换使用 |
TABLE
TABLE | 可选关键字 |
EXTENDED
EXTENDED | 可选。加上后返回完整的表元数据信息 |
dt_name
dt_name | 动态表名称，可包含 schema 前缀 |
使用示例
示例 1：查看动态表列结构
DESC dt_agg;
+-------------+-----------+---------+
| column_name | data_type | comment |
+-------------+-----------+---------+
| j | int | NULL |
| cnt | bigint | NULL |
+-------------+-----------+---------+
示例 2：查看动态表完整信息
DESC EXTENDED dt_agg;
+------------------------+-------------------------------------------+
| column_name | data_type |
+------------------------+-------------------------------------------+
| j | int |
| cnt | bigint |
| | |
| # detailed table info | |
| workspace | quick_start |
| schema | public |
| name | dt_agg |
| creator | qiliang |
| created_time | 2024-07-23 18:02:15.774 |
| last_modified_time | 2024-07-24 11:01:11.289 |
| comment | NULL |
| properties | () |
| type | DYNAMIC TABLE |
| view_text | SELECT j, COUNT(*) AS cnt FROM dt_tran... |
| view_original_text | (select j,count(*) as cnt from dt_tran...) |
| source_tables | [...] |
| refresh_type | on schedule |
| refresh_start_time | 2024-07-23 18:02:15.725 |
| refresh_interval_second| 60 |
| refresh_vcluster | quick_start.DEFAULT |
| format | PARQUET |
| statistics | 5 rows 2729 bytes |
+------------------------+-------------------------------------------+
EXTENDED
EXTENDED
模式返回的关键字段：
| 字段 | 说明 |
|---|
type
type | 对象类型，动态表显示 DYNAMIC TABLE
DYNAMIC TABLE |
view_text
view_text | 动态表的查询定义（格式化后） |
view_original_text
view_original_text | 原始查询定义 |
source_tables
source_tables | 源表列表 |
refresh_type
refresh_type | 刷新类型（on schedule
on schedule 表示定时刷新） |
refresh_interval_second
refresh_interval_second | 刷新间隔（秒） |
refresh_vcluster
refresh_vcluster | 刷新使用的计算集群 |
refresh_start_time
refresh_start_time | 刷新起始时间 |
format
format | 存储格式（通常为 PARQUET
PARQUET ） |
statistics
statistics | 行数和字节数统计 |
注意事项
- 不加
EXTENDED
EXTENDED
时仅返回列结构（列名、数据类型、注释）
- 加
EXTENDED
EXTENDED
后返回完整元数据，包括刷新配置、源表、查询定义等
- 动态表不支持
DESC TABLE ... HISTORY
DESC TABLE ... HISTORY
语法，查看历史版本请使用 DESC HISTORY <dt_name>
DESC HISTORY <dt_name>
相关文档
