SHOW TBLPROPERTIES
描述
该语句返回表属性的值,并为属性键提供一个可选值。 如果未指定键,则返回所有属性。
语法
SHOW TBLPROPERTIES table_identifier
[ ( unquoted_property_key | property_key_as_string_literal ) ]
参数
-
table_identifier
指定现有表的表名。表可以选择使用数据库名称进行限定。
语法:
[ database_name. ] table_name
-
unquoted_property_key
以非引号形式指定属性键。 键可以由点分隔的多个部分组成。
语法:
[ key_part1 ] [ .key_part2 ] [ ... ]
-
property_key_as_string_literal
将属性键值指定为字符串文字。
注意
- 此语句返回的属性值不包括 Spark 和 Hive 内部的一些属性。 排除的属性包括
- 所有以
spark.sql
为前缀的属性 - 属性键,例如:
EXTERNAL
、comment
- Hive 内部生成的所有用于存储统计信息的属性。 其中一些属性是:
numFiles
、numPartitions
、numRows
。
- 所有以
示例
-- create a table `customer` in database `salesdb`
USE salesdb;
CREATE TABLE customer(cust_code INT, name VARCHAR(100), cust_addr STRING)
TBLPROPERTIES ('created.by.user' = 'John', 'created.date' = '01-01-2001');
-- show all the user specified properties for table `customer`
SHOW TBLPROPERTIES customer;
+---------------------+----------+
| key| value|
+---------------------+----------+
| created.by.user| John|
| created.date|01-01-2001|
|transient_lastDdlTime|1567554931|
+---------------------+----------+
-- show all the user specified properties for a qualified table `customer`
-- in database `salesdb`
SHOW TBLPROPERTIES salesdb.customer;
+---------------------+----------+
| key| value|
+---------------------+----------+
| created.by.user| John|
| created.date|01-01-2001|
|transient_lastDdlTime|1567554931|
+---------------------+----------+
-- show value for unquoted property key `created.by.user`
SHOW TBLPROPERTIES customer (created.by.user);
+-----+
|value|
+-----+
| John|
+-----+
-- show value for property `created.date`` specified as string literal
SHOW TBLPROPERTIES customer ('created.date');
+----------+
| value|
+----------+
|01-01-2001|
+----------+