# DESCRIBE
#### 命令功能
DESCRIBE命令用于显示表的详细信息或统计信息。
#### 命令格式
显示表统计信息：
DESCRIBE *\[EXTENDED\|FORMATTED\]* *\[database_name.\]table_name\|* *DELTA.\`obs://bucket_name/tbl_path\`* *;*
显示表详细信息：
DESCRIBE *DETAIL* *\[database_name.\]table_name\|* *DELTA.\`obs://bucket_name/tbl_path\`* *;*
#### 所需权限
- SQL权限
表1DESCRIBE所需权限列表 
| 权限描述               |
|:---|
| 表的DESCRIBE_TABLE权限 |
   
- 细粒度权限：dli:table:describeTable。

- 由LakeFormation提供的元数据服务，权限配置详见LakeFormation文档。
 
#### 示例
```
DESCRIBE FORMATTED delta_table0;
DESCRIBE FORMATTED delta.`obs://bucket_name0/db0/delta_table0`;
DESCRIBE DETAIL delta_table0;
```
#### 系统响应
返回表的详细信息或统计信息。
表2结果参数描述 
| 参数名              | 参数含义              |
|:---|:---|
| format           | 表的格式，在这里是delta    |
| id               | 表的唯一id            |
| name             | 在metaserver中定义的表名 |
| description      | 关于表的说明            |
| location         | 表的存储路径            |
| createdAt        | 建表时间戳             |
| lastModified     | 最后一次修改的时间戳        |
| partitionColumns | 分区列               |
| numFiles         | 表的最新版本中的文件个数      |
| sizeInBytes      | 表的最新快照的大小（以字节为单位） |
| properties       | 为此表设置的所有属性        |
| minReaderVersion | 可以读取该表的最低Reader版本 |
| minWriterVersion | 可以写入该表的最低Writer版本 |