查看动态表历史版本（DESC HISTORY）

DESC HISTORY

DESC HISTORY

命令查看动态表的历史快照记录，包含每次刷新写入的版本号、时间、行数、变更统计和上游源表版本。可配合 Time Travel 查询指定历史时刻的数据。

语法

DESC HISTORY [<schema_name>.]<dt_name>;

返回字段

字段	说明
`version` version	快照版本号，从 1 开始递增
`time` time	本次快照写入时间
`total_rows` total_rows	本次快照写入后的总行数
`total_bytes` total_bytes	本次快照的存储字节数
`user` user	触发本次操作的用户
`operation` operation	操作类型： `CREATE` CREATE （建表时的初始记录）/ `REFRESH` REFRESH （每次刷新）
`job_id` job_id	作业 ID
`source_tables` source_tables	上游源表信息，包含表名、workspace、schema、版本号（ `version` version ）、序列号（ `sequence` sequence ）和提交时间（ `commit_time` commit_time ）。增量引擎通过 `version` version / `sequence` sequence 追踪上游变更边界。
`stats` stats	本次刷新的行变更统计，格式为 `{"rows_inserted":"N","rows_deleted":"N"}` {"rows_inserted":"N","rows_deleted":"N"} ； `CREATE` CREATE 记录为 null

使用示例

DESC HISTORY dws_sales_dashboard;

实测输出（含 4 个版本）：

+---------+---------------------------+------------+-------------+----------+-----------+---------------------+...+----------------------------------+ | version | time | total_rows | total_bytes | user | operation | job_id |...| stats | +---------+---------------------------+------------+-------------+----------+-----------+---------------------+...+----------------------------------+ | 4 | 2026-06-13T09:28:53.593 | 3 | 10399 | qiliang | REFRESH | 20260613... |...| {"rows_inserted":"1","rows_deleted":"1"} | | 3 | 2026-06-13T09:27:29.152 | 3 | 5089 | qiliang | REFRESH | 20260613... |...| {"rows_inserted":"1","rows_deleted":"0"} | | 2 | 2026-06-13T09:26:30.983 | 2 | 2559 | qiliang | REFRESH | 20260613... |...| {"rows_inserted":"2","rows_deleted":"0"} | | 1 | 2026-06-13T09:25:31.306 | 0 | 0 | qiliang | CREATE | 20260613... |...| null | +---------+---------------------------+------------+-------------+----------+-----------+---------------------+...+----------------------------------+

version=1 的

operation

operation

是

CREATE

CREATE

，是动态表创建时的初始记录，

total_rows=0

total_rows=0

是正常的——此时还没有触发刷新。

与 SHOW DYNAMIC TABLE REFRESH HISTORY 的区别

两个命令都能看刷新记录，侧重不同：

	`DESC HISTORY` DESC HISTORY	`SHOW DYNAMIC TABLE REFRESH HISTORY` SHOW DYNAMIC TABLE REFRESH HISTORY
主要用途	查快照版本，配合 Time Travel	诊断刷新状态（模式/耗时/积压/失败原因）
关键字段	version、total_rows、source_tables 版本信息	refresh_mode、duration、state、error_message
支持过滤	不支持 WHERE	支持 WHERE + LIMIT

注意事项

可查看的历史版本受
```
data_retention_days
```
data_retention_days
保留天数限制（默认 1 天）
结合
```
TIMESTAMP AS OF
```
TIMESTAMP AS OF
可查询指定版本的数据：
```
SELECT * FROM dt TIMESTAMP AS OF '2026-06-13 09:27:00'
```
SELECT * FROM dt TIMESTAMP AS OF '2026-06-13 09:27:00'

查看动态表历史版本（DESC HISTORY）

语法

返回字段

使用示例

与 SHOW DYNAMIC TABLE REFRESH HISTORY 的区别

注意事项

相关文档