SHOW TBLPROPERTIES (Databricks SQL)

Devuelve el valor de una propiedad de tabla dado un valor opcional para una clave de propiedad. Si no se especifica ninguna clave, se devuelven todas las propiedades.

Sintaxis

SHOW TBLPROPERTIES table_name
   [ ( [unquoted_property_key | property_key_as_string_literal] ) ]

unquoted_property_key
  key_part1 [. ...]

Parámetros

  • Table_name

    Identifica la tabla. El nombre no debe incluir una especificación temporal.

  • unquoted_property_key

    Clave de propiedad en formato sin comillas. La clave puede constar de varias partes separadas por un punto.

  • property_key_as_string_literal

    Valor de clave de propiedad como literal de cadena.

Nota

El valor de propiedad devuelto por esta instrucción excluye algunas propiedades internas de Spark y Hive. Las propiedades excluidas son:

  • Todas las propiedades que comienzan con el prefijo spark.sql
  • Claves de propiedad como: EXTERNAL , comment
  • Todas las propiedades generadas internamente por Hive para almacenar estadísticas. Algunas de estas propiedades son: numFiles , numPartitions , numRows .

Ejemplos

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