Udostępnij za pośrednictwem

SHOW TBLPROPERTIES

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Zwraca wartość właściwości tabeli, biorąc pod uwagę opcjonalną wartość klucza właściwości. Jeśli nie określono żadnego klucza, zwracane są wszystkie właściwości i opcje. Opcje tabeli są poprzedzone prefiksem option.

Składnia

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

unquoted_property_key
  key_part1 [. ...]

Parametry

  • table_name

    Identyfikuje tabelę. Nazwa nie może zawierać specyfikacji czasowej ani specyfikacji opcji.

  • unquoted_property_key

    Klucz właściwości w formularzu bez cudzysłów. Klucz może składać się z wielu części oddzielonych kropką.

  • property_key_as_string_literal

    Wartość klucza właściwości jako literał ciągu.

Uwaga

Wartość właściwości zwrócona przez tę instrukcję wyklucza niektóre właściwości wewnętrzne dla platformy Spark i gałęzi. Wykluczone właściwości to:

  • Wszystkie właściwości rozpoczynające się od prefiksu spark.sql
  • Klucze właściwości, takie jak: EXTERNAL, comment
  • Wszystkie właściwości generowane wewnętrznie przez gałąź do przechowywania statystyk. Niektóre z tych właściwości to: numFiles, , numRowsnumPartitions.

Przykłady

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