显示 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。
-
所有以前缀
示例
-- 在数据库 `salesdb` 中创建一个表 `customer`
USE salesdb;
CREATE TABLE customer(cust_code INT, name VARCHAR(100), cust_addr STRING)
TBLPROPERTIES ('created.by.user' = 'John', 'created.date' = '01-01-2001');
-- 显示表 `customer` 的所有用户指定属性
SHOW TBLPROPERTIES customer;
+---------------------+----------+
| key| value|
+---------------------+----------+
| created.by.user| John|
| created.date|01-01-2001|
|transient_lastDdlTime|1567554931|
+---------------------+----------+
-- 显示经过限定的表 `customer` 的所有用户指定属性
-- 在数据库 `salesdb` 中
SHOW TBLPROPERTIES salesdb.customer;
+---------------------+----------+
| key| value|
+---------------------+----------+
| created.by.user| John|
| created.date|01-01-2001|
|transient_lastDdlTime|1567554931|
+---------------------+----------+
-- 显示未引用属性键 `created.by.user` 的值
SHOW TBLPROPERTIES customer (created.by.user);
+-----+
|value|
+-----+
| John|
+-----+
-- 显示属性 `created.date` 的值,以字符串字面值指定
SHOW TBLPROPERTIES customer ('created.date');
+----------+
| value|
+----------+
|01-01-2001|
+----------+