DESCRIBE TABLE
Van toepassing op:
Databricks SQL Databricks Runtime
Retourneert de basismetagegevens van een table. De metagegevensinformatie bevat column naam, column type en column opmerking. U kunt desgewenst een partition specificatie of column naam opgeven om de metagegevens te retourneren die betrekking hebben op respectievelijk een partition of column. Met Delta tablesworden niet alle velden geretourneerd.
Syntaxis
{ DESC | DESCRIBE } [ TABLE ] [ EXTENDED | FORMATTED ] table_name { [ PARTITION clause ] | [ column_name ] }
Parameters
EXTENDEDofFORMATTEDIndien opgegeven geeft gedetailleerde informatie weer over de opgegeven columns, inclusief de column statistieken die door de opdracht worden verzameld, en aanvullende metagegevensinformatie (zoals schema kwalificatie, eigenaar en toegangstijd).
-
Identificeert de table die moet worden beschreven. De naam mag geen tijdelijke specificatie of optiesspecificatie gebruiken. Als de table niet kan worden gevonden, genereert Azure Databricks een TABLE_OR_VIEW_NOT_FOUND fout.
-
Een optionele parameter die Databricks SQL leidt om toevoegingsmetagegevens voor de benoemde partities te retourneren.
-
Een optionele parameter met de column naam die moet worden beschreven. Momenteel is het niet toegestaan om geneste columns op te geven.
Parameters
partition_spec en column_name sluiten elkaar wederzijds uit en kunnen niet samen worden opgegeven.
Voorbeelden
-- Creates a table `customer`. Assumes current schema is `salesdb`.
> CREATE TABLE customer(
cust_id INT,
state VARCHAR(20),
name STRING COMMENT 'Short name'
)
USING parquet
PARTITIONED BY (state);
> INSERT INTO customer PARTITION (state = 'AR') VALUES (100, 'Mike');
-- Returns basic metadata information for unqualified table `customer`
> DESCRIBE TABLE customer;
col_name data_type comment
----------------------- --------- ----------
cust_id int null
name string Short name
state string null
# Partition Information
# col_name data_type comment
state string null
-- Returns basic metadata information for qualified table `customer`
> DESCRIBE TABLE salesdb.customer;
col_name data_type comment
----------------------- --------- ----------
cust_id int null
name string Short name
state string null
# Partition Information
# col_name data_type comment
state string null
-- Returns additional metadata such as parent schema, owner, access time etc.
> DESCRIBE TABLE EXTENDED customer;
col_name data_type comment
---------------------------- ------------------------------ ----------
cust_id int null
name string Short name
state string null
# Partition Information
# col_name data_type comment
state string null
# Detailed Table Information
Database default
Table customer
Owner <TABLE OWNER>
Created Time Tue Apr 07 22:56:34 JST 2020
Last Access UNKNOWN
Created By <SPARK VERSION>
Type MANAGED
Provider parquet
Location file:/tmp/salesdb.db/custom...
Serde Library org.apache.hadoop.hive.ql.i...
InputFormat org.apache.hadoop.hive.ql.i...
OutputFormat org.apache.hadoop.hive.ql.i...
Partition Provider Catalog
-- Returns partition metadata such as partitioning column name, column type and comment.
> DESCRIBE TABLE EXTENDED customer PARTITION (state = 'AR');
col_name data_type comment
------------------------------ ------------------------------ ----------
cust_id int null
name string Short name
state string null
# Partition Information
# col_name data_type comment
state string null
# Detailed Partition Inform...
Database default
Table customer
Partition Values [state=AR]
Location file:/tmp/salesdb.db/custom...
Serde Library org.apache.hadoop.hive.ql.i...
InputFormat org.apache.hadoop.hive.ql.i...
OutputFormat org.apache.hadoop.hive.ql.i...
Storage Properties [serialization.format=1, pa...
Partition Parameters {transient_lastDdlTime=1586...
Created Time Tue Apr 07 23:05:43 JST 2020
Last Access UNKNOWN
Partition Statistics 659 bytes
# Storage Information
Location file:/tmp/salesdb.db/custom...
Serde Library org.apache.hadoop.hive.ql.i...
InputFormat org.apache.hadoop.hive.ql.i...
OutputFormat org.apache.hadoop.hive.ql.i...
------------------------------ ------------------------------ ----------
-- Returns the metadata for `name` column.
-- Optional `TABLE` clause is omitted and column is fully qualified.
> DESCRIBE customer salesdb.customer.name;
info_name info_value
--------- ----------
col_name name
data_type string
comment Short name
DETAILS BESCHRIJVEN
DESCRIBE DETAIL [schema_name.]table_name
Retourneert informatie over schema, partitioneren, table grootte, enzovoort. Voor Delta tablesziet u bijvoorbeeld de huidige lezer- en schrijversversies van een table. Zie de details van Delta Lake table met de instructie 'beschrijf detail' om de details schemate bekijken.