VISA TBLPROPERTIES

Gäller för:check markerad ja Databricks SQL-kontroll markerad som ja Databricks Runtime

Returnerar värdet för en tabellegenskap givet ett valfritt värde för en egenskapsnyckel. Om ingen nyckel anges returneras alla egenskaper och alternativ. Tabellalternativen har prefixet option.

Syntax

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

unquoted_property_key
  key_part1 [. ...]

Parametrar

  • Table_name

    Identifierar tabellen. Namnet får inte innehålla en temporal specifikation.

  • unquoted_property_key

    Egenskapsnyckeln i icke-citatformat. Nyckeln kan bestå av flera delar avgränsade med en punkt.

  • property_key_as_string_literal

    Ett egenskapsnyckelvärde som en strängliteral.

Observera

Egenskapsvärdet som returneras av den här instruktionen exkluderar vissa egenskaper som är interna för spark och hive. De exkluderade egenskaperna är:

  • Alla egenskaper som börjar med prefix spark.sql
  • Egenskapsnycklar som: EXTERNAL, comment
  • Alla egenskaper som genereras internt av hive för att lagra statistik. Några av dessa egenskaper är: numFiles, numPartitions, numRows.

Exempel

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