SHOW TBLPROPERTIES

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime

Gibt den Wert einer Tabelleneigenschaft mit einem optionalen Wert für einen Eigenschaftsschlüssel zurück. Wird kein Schlüssel angegeben, werden alle Eigenschaften und Optionen zurückgegeben. Tabellenoptionen erhalten das Präfix option.

Syntax

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

unquoted_property_key
  key_part1 [. ...]

Parameter

  • table_name

    Bestimmt die Tabelle. Der Name darf keine temporale Spezifikation enthalten.

  • unquoted_property_key

    Der Eigenschaftsschlüssel ohne Anführungszeichen. Der Schlüssel kann aus mehreren Teilen bestehen, die durch einen Punkt getrennt sind.

  • property_key_as_string_literal

    Ein Eigenschaftsschlüsselwert als Zeichenfolgenliteral.

Hinweis

Der von dieser Anweisung zurückgegebene Eigenschaftswert schließt einige Eigenschaften aus, bei denen es sich um interne Eigenschaften von Spark und Hive handelt. Folgende Eigenschaften werden ausgeschlossen:

  • Alle Eigenschaften, die mit dem Präfix spark.sql beginnen
  • Eigenschaftenschlüssel, z. B.: EXTERNAL, comment
  • Alle Eigenschaften, die intern von Hive zum Speichern von Statistiken generiert werden. Zu diesen Eigenschaften zählen: numFiles, numPartitions, numRows.

Beispiele

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