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