Dela via


SHOW TBLPROPERTIES

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Returnerar värdet för en table egenskap med ett valfritt värde för en egenskapsnyckel. Om ingen nyckel anges returneras alla egenskaper och alternativ. Table-alternativen är försedda med prefixet option.

Syntax

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

unquoted_property_key
  key_part1 [. ...]

Parameters

  • table_name

    Identifierar table:n. Namnet får inte innehålla en temporal specifikation eller alternativspecifikation.

  • unquoted_property_key

    Egenskapsnyckeln i ociterad form. Nyckeln kan bestå av flera delar avgränsade med en punkt.

  • property_key_as_string_literal

    Ett egenskapsnyckelvärde som en strängliteral.

Kommentar

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