查看表历史版本(DESC HISTORY)
DESC HISTORY
DESC HISTORY
命令用于查看普通表的历史版本记录,包括每次变更的版本号、时间、行数、操作类型等。
语法
DESC HISTORY [schema_name.]<table_name>;
使用示例
DESC HISTORY students;
+---------+-------------------------+------------+-------------+----------+-----------------+---------------------------+
| version | time | total_rows | total_bytes | user | operation | job_id |
+---------+-------------------------+------------+-------------+----------+-----------------+---------------------------+
| 2 | 2024-06-14 11:18:43.238 | 37 | 1387 | UAT_TEST | CREATE_TABLE_AS | 2024061403184277861pl5... |
+---------+-------------------------+------------+-------------+----------+-----------------+---------------------------+
返回字段说明
| 字段 | 说明 |
|---|
version
version | 版本号,每次变更递增 |
time
time | 版本创建时间 |
total_rows
total_rows | 该版本下的总行数 |
total_bytes
total_bytes | 该版本下的总字节数 |
user
user | 操作者 |
operation
operation | 操作类型:CREATE
CREATE (创建)、INSERT
INSERT (插入)、TRUNCATE
TRUNCATE (清空)、CREATE_TABLE_AS
CREATE_TABLE_AS (CTAS)等 |
job_id
job_id | 关联的作业 ID |
注意事项
- 可查看的历史版本数量受
data_retention_days
data_retention_days
保留周期限制(默认 1 天)
- 结合
TIMESTAMP AS OF
TIMESTAMP AS OF
可查询指定时间点的表数据
- 结合
UNDROP TABLE
UNDROP TABLE
可恢复被删除的表
相关文档