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