TBLEIGENSCHAPPEN WEERGEVEN

  • Artikel

Van toepassing op:controleren met ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime

Retourneert de waarde van een tabeleigenschap op basis van een optionele waarde voor een eigenschapssleutel. Als er geen sleutel is opgegeven, worden alle eigenschappen en opties geretourneerd. Tabelopties worden voorafgegaan door option.

Syntaxis

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

unquoted_property_key
  key_part1 [. ...]

Parameters

  • Table_name

    Identificeert de tabel. De naam mag geen tijdelijke specificatie bevatten.

  • unquoted_property_key

    De eigenschapssleutel in niet-aanhalingstekens. De sleutel kan bestaan uit meerdere delen, gescheiden door een punt.

  • property_key_as_string_literal

    Een eigenschapssleutelwaarde als een letterlijke tekenreeks.

Opmerking

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