SHOW TBLPROPERTIES

  • Article

S’applique à : case marquée oui Databricks SQL case marquée oui Databricks Runtime

Renvoie la valeur d’une propriété de table en fonction d’une valeur optionnelle pour une clé de propriété. Si aucune clé n’est spécifiée, toutes les propriétés et options sont retournées. Les options de table sont préfixées avec option.

Syntaxe

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

unquoted_property_key
  key_part1 [. ...]

Paramètres

  • table_name

    Identifie la table. Le nom ne doit pas inclure de spécification temporelle ou de spécification d’options.

  • unquoted_property_key

    Clé de propriété sous une forme sans guillemets. La clé peut être constituée de plusieurs parties séparées par un point.

  • property_key_as_string_literal

    Valeur de clé de propriété en tant que littéral de chaîne.

Notes

La valeur de propriété renvoyée par cette instruction exclut certaines propriétés internes de Spark et Hive. Les propriétés exclues sont les suivantes :

  • Toutes les propriétés qui commencent par le préfixe spark.sql
  • Clés de propriété telles que : EXTERNAL, comment
  • Toutes les propriétés générées en interne par Hive pour stocker des statistiques. Voici quelques-unes de ces propriétés : numFiles, numPartitions, numRows.

Exemples

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