SHOW TBLPROPERTIES
Van toepassing op: Databricks SQL Databricks Runtime
Retourneert de waarde van een table eigenschap op basis van een optionele waarde voor een eigenschapssleutel. Als er geen sleutel is opgegeven, worden alle eigenschappen en opties geretourneerd.
Table opties worden voorafgegaan door option
.
Syntaxis
SHOW TBLPROPERTIES table_name
[ ( [unquoted_property_key | property_key_as_string_literal] ) ]
unquoted_property_key
key_part1 [. ...]
Parameters
-
Identificeert de table. De naam mag geen tijdelijke specificatie of optiesspecificatie bevatten.
unquoted_property_key
De eigenschapssleutel in niet-aanhalingeerde vorm. De sleutel kan bestaan uit meerdere delen gescheiden door een punt.
property_key_as_string_literal
Een eigenschapssleutelwaarde als een letterlijke tekenreeks.
Notitie
Eigenschapswaarde die door deze instructie wordt geretourneerd, sluit enkele eigenschappen uit die intern zijn voor spark en hive. De uitgesloten eigenschappen zijn:
- Alle eigenschappen die beginnen met voorvoegsel
spark.sql
- Eigenschapssleutels zoals:
EXTERNAL
,comment
- Alle eigenschappen die intern door Hive worden gegenereerd om statistieken op te slaan. Enkele van deze eigenschappen zijn:
numFiles
,numPartitions
, .numRows
Voorbeelden
-- create a table `customer` in schema `salessc`
> USE salessc;
> 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 schema `salessc`
> SHOW TBLPROPERTIES salessc.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