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|
+----------+