SHOW TBLPROPERTIES
描述
此语句返回给定属性键的可选值的表属性值。 如果未指定键,则返回所有属性。
语法
SHOW TBLPROPERTIES table_identifier
[ ( unquoted_property_key | property_key_as_string_literal ) ]
参数
-
table_identifier
指定现有表的表名。 该表可以选择使用数据库名称进行限定。
语法:
[ 数据库名称. ] 表名
-
unquoted_property_key
以非引号形式指定属性键。 该键可以包含多个由点分隔的部分。
语法:
[ 键部分1 ] [ .键部分2 ] [ ... ]
-
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|
+----------+