更新时间:2024-12-25 GMT+08:00
分享

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权限
表1 DESCRIBE所需权限列表

权限描述

表的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版本

相关文档