MOSTRAR PROPRIEDADES TBL
Aplica-se a: do SQL do Databricks Databricks Runtime
Devolve o valor de uma propriedade de tabela dado um valor opcional para uma chave de propriedade. Se não for especificada nenhuma chave, todas as propriedades e opções são devolvidas.
As opções de tabela têm o prefixo option
.
Sintaxe
SHOW TBLPROPERTIES table_name
[ ( [unquoted_property_key | property_key_as_string_literal] ) ]
unquoted_property_key
key_part1 [. ...]
Parâmetros
-
Identifica a tabela. O nome não pode incluir uma especificação temporal.
unquoted_property_key
A chave de propriedade no formato não listado. A chave pode consistir em várias partes separadas por um ponto.
property_key_as_string_literal
Um valor de chave de propriedade como um literal de cadeia.
Nota
O valor da propriedade devolvido por esta instrução exclui algumas propriedades internas do Apache Spark e do Hive. As propriedades excluídas são:
- Todas as propriedades que começam com o prefixo
spark.sql
- Chaves de propriedade, tais como:
EXTERNAL
,comment
- Todas as propriedades geradas internamente pelo Hive para armazenar estatísticas. Algumas destas propriedades são:
numFiles
, ,numPartitions
numRows
.
Exemplos
-- 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