SHOW TBLPROPERTIES

  • Artículo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Devuelve el valor de una propiedad de tabla dado un valor opcional para una clave de propiedad. Si no se especifica una clave, se devolverán todas las propiedades. Las opciones de tabla usan el prefijo option.

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 las siguientes:

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