查看物化视图结构(DESC MATERIALIZED VIEW)
功能概述
DESC
DESC
命令用于查看物化视图的列结构,包括字段名、数据类型和注释。
DESC EXTENDED
DESC EXTENDED
可以进一步查看物化视图的详细元数据,如创建时间、查询定义、源表信息等。
有关更多详细信息,请参阅物化视图。
语法
DESC [EXTENDED] [schema_name.]<mv_name>
参数说明
| 参数 | 是否必填 | 说明 |
|---|
EXTENDED
EXTENDED | 否 | 显示扩展信息,包括物化视图的元数据、查询定义、源表等详细信息 |
schema_name
schema_name | 否 | 指定 schema 名称。如果未指定,默认使用当前 schema |
mv_name
mv_name | 是 | 要查看的物化视图名称 |
返回列说明
基本模式(不加 EXTENDED)
| 列名 | 说明 |
|---|
column_name
column_name | 列名 |
data_type
data_type | 数据类型 |
comment
comment | 列注释 |
扩展模式(加 EXTENDED)
在基本列信息之后,还会返回以下元数据行:
| 字段 | 说明 |
|---|
workspace
workspace | 工作空间名称 |
schema
schema | schema 名称 |
name
name | 物化视图名称 |
creator
creator | 创建者 |
created_time
created_time | 创建时间 |
last_modified_time
last_modified_time | 最后修改时间 |
type
type | 对象类型,值为 MATERIALIZED VIEW
MATERIALIZED VIEW |
view_text
view_text | 物化视图的完整查询语句(含 schema 前缀) |
view_original_text
view_original_text | 物化视图的原始查询语句 |
is_materialized
is_materialized | 是否已物化,值为 true
true |
source_tables
source_tables | 依赖的源表列表 |
format
format | 存储格式,如 PARQUET
PARQUET |
statistics
statistics | 数据统计信息(行数和字节数) |
使用示例
示例 1:查看物化视图的列结构
DESC doc_test.mv_test_sales;
返回结果:
+-------------+-----------+---------+
| column_name | data_type | comment |
+-------------+-----------+---------+
| id | int | |
| name | string | |
+-------------+-----------+---------+
示例 2:查看物化视图的扩展信息
DESC EXTENDED doc_test.mv_test_sales;
返回结果(部分):
+------------------------------+------------------------------------------+---------+
| column_name | data_type | comment |
+------------------------------+------------------------------------------+---------+
| id | int | |
| name | string | |
| | | |
| # detailed table information | | |
| workspace | quick_start | |
| schema | doc_test | |
| name | mv_test_sales | |
| creator | qiliang | |
| type | MATERIALIZED VIEW | |
| view_original_text | SELECT id, name FROM doc_test.employees; | |
| is_materialized | true | |
| format | PARQUET | |
| statistics | 5 rows 2610 bytes | |
+------------------------------+------------------------------------------+---------+
注意事项
DESC
DESC
与 DESCRIBE
DESCRIBE
等价,两者可以互换使用。
- 物化视图的
DESC
DESC
语法与普通表相同,详见 DESC TABLE。
DESC EXTENDED
DESC EXTENDED
返回的 source_tables
source_tables
字段记录了物化视图依赖的所有源表,可用于分析数据血缘。
相关命令