DESC 命令参考

功能概述

查看云器 Lakehouse 中指定对象的详细结构或属性信息。

DESCRIBE

DESCRIBE

可缩写为

DESC

DESC

。

语法

DESC[RIBE] <object_type> [ EXTENDED ] <object_name>

参数说明

参数说明是否必填

参数	说明	是否必填
`<object_type>` <object_type>	要查看的对象类型，如 `TABLE` TABLE 、 `SCHEMA` SCHEMA 、 `VCLUSTER` VCLUSTER 等	是
`EXTENDED` EXTENDED	展示更多详细信息	否
`<object_name>` <object_name>	对象名称，可包含 schema 前缀	是

<object_type>

<object_type>

要查看的对象类型，如

TABLE

TABLE

、

SCHEMA

SCHEMA

、

VCLUSTER

VCLUSTER

等

是

EXTENDED

EXTENDED

展示更多详细信息

否

<object_name>

<object_name>

对象名称，可包含 schema 前缀

是

支持的对象类型

对象类型	语法示例	说明
普通表	`DESC TABLE <name>` DESC TABLE <name>	查看表结构（列名、类型、注释）
动态表	`DESC DYNAMIC TABLE <name>` DESC DYNAMIC TABLE <name>	查看动态表结构和刷新配置
物化视图	`DESC MATERIALIZED VIEW <name>` DESC MATERIALIZED VIEW <name>	查看物化视图结构
视图	`DESC VIEW <name>` DESC VIEW <name>	查看视图定义
外部表	`DESC EXTERNAL TABLE <name>` DESC EXTERNAL TABLE <name>	查看外部表结构
Table Stream	`DESC TABLE STREAM <name>` DESC TABLE STREAM <name>	查看 Stream 配置和模式
Schema	`DESC SCHEMA <name>` DESC SCHEMA <name>	查看 Schema 信息
外部 Schema	`DESC EXTERNAL SCHEMA <name>` DESC EXTERNAL SCHEMA <name>	查看外部 Schema 配置
外部 Catalog	`DESC CATALOG <name>` DESC CATALOG <name>	查看 External Catalog 信息
计算集群	`DESC VCLUSTER <name>` DESC VCLUSTER <name>	查看 VCluster 规格和状态
连接	`DESC CONNECTION <name>` DESC CONNECTION <name>	查看 Connection 配置
数据分享	`DESC SHARE <name>` DESC SHARE <name>	查看 Share 配置
索引	`DESC INDEX <name>` DESC INDEX <name>	查看索引信息
作业	`DESC JOB <job_id>` DESC JOB <job_id>	查看作业执行信息
历史版本	`DESC HISTORY <name>` DESC HISTORY <name>	查看表的历史版本
函数	`DESC FUNCTION <name>` DESC FUNCTION <name>	查看函数定义
同义词	`DESC SYNONYM <name>` DESC SYNONYM <name>	查看同义词映射

权限要求

执行

DESC

DESC

语句通常只需对目标对象具有基本的查看权限（

USAGE

USAGE

或

SELECT

SELECT

）。

注意事项

```
DESCRIBE
```
DESCRIBE
和
```
DESC
```
DESC
等价，可互换使用
部分对象类型支持
```
EXTENDED
```
EXTENDED
参数展示更多信息
```
DESC HISTORY
```
DESC HISTORY
可查看表/动态表/物化视图的历史版本信息

DESC 命令参考

功能概述

语法

参数说明

支持的对象类型

权限要求

注意事项

语法参考

数据对象

Schema 与 Catalog

计算与连接

索引与作业

其他