DESC
功能
您可以使用该语句进行如下操作:
语法
DESC[RIBE] [catalog_name.][db_name.]table_name [ALL];
参数说明
参数 | 必选 | 说明 |
---|---|---|
catalog_name | 否 | Internal catalog 或 external catalog 的名称。
|
db_name | 否 | 数据库名称。 |
table_name | 是 | 表名称。 |
ALL | 否 |
|
返回信息说明
+-----------+---------------+-------+------+------+-----+---------+-------+
| IndexName | IndexKeysType | Field | Type | Null | Key | Default | Extra |
+-----------+---------------+-------+------+------+-----+---------+-------+
返回信息中的参数说明:
参数 | 说明 |
---|---|
IndexName | 表名。如查看外部数据源表结构,则不返回该参数。 |
IndexKeysType | 表的排序键类型。如查看外部数据源表结构,则不返回该参数。 |
Field | 列名。 |
Type | 列的数据型。 |
Null | 是否允许为 NULL。
|
Key | 是否为排序键。
|
Default | 数据类型的默认值。如该数据类型没有默认值,则返回 NULL。 |
Extra |
|
说明:有关物化视图的展示,请参见示例二。
示例
示例一:查看 StarRocks 的 example_table
表结构信息。
DESC example_table;
或
DESC default_catalog.example_db.example_table;
返回信息如下:
+-------+---------------+------+-------+---------+-------+
| Field | Type | Null | Key | Default | Extra |
+-------+---------------+------+-------+---------+-------+
| k1 | TINYINT | Yes | true | NULL | |
| k2 | DECIMAL(10,2) | Yes | true | 10.5 | |
| k3 | CHAR(10) | Yes | false | NULL | |
| v1 | INT | Yes | false | NULL | |
+-------+---------------+------+-------+---------+-------+
示例二:查看 StarRocks 的 sales_records
表结构、排序键类型和物化视图。如下所示, sales_records
表只有一张物化视图 store_amt
。
DESC db1.sales_records ALL;
+---------------+---------------+-----------+--------+------+-------+---------+-------+
| IndexName | IndexKeysType | Field | Type | Null | Key | Default | Extra |
+---------------+---------------+-----------+--------+------+-------+---------+-------+
| sales_records | DUP_KEYS | record_id | INT | Yes | true | NULL | |
| | | seller_id | INT | Yes | true | NULL | |
| | | store_id | INT | Yes | true | NULL | |
| | | sale_date | DATE | Yes | false | NULL | NONE |
| | | sale_amt | BIGINT | Yes | false | NULL | NONE |
| | | | | | | | |
| store_amt | AGG_KEYS | store_id | INT | Yes | true | NULL | |
| | | sale_amt | BIGINT | Yes | false | NULL | SUM |
+---------------+---------------+-----------+--------+------+-------+---------+-------+
示例三:查看 Hive 中 hive_table
表结构。
DESC hive_catalog.hive_db.hive_table;
+-------+----------------+------+-------+---------+---------------+
| Field | Type | Null | Key | Default | Extra |
+-------+----------------+------+-------+---------+---------------+
| id | INT | Yes | false | NULL | |
| name | VARCHAR(65533) | Yes | false | NULL | |
| date | DATE | Yes | false | NULL | partition key |
+-------+----------------+------+-------+---------+---------------+