DESCRIBE TABLE
Gäller för:
Databricks Databricks Runtime
Returnerar grundläggande metadatainformation för en tabell. Metadatainformationen innehåller kolumnnamn, kolumntyp och kolumnkommentare. Du kan också ange en partitionsspecifikation eller ett kolumnnamn för att returnera metadata som hör till en partition eller kolumn. Med Delta-tabeller returneras inte alla fält.
Syntax
{ DESC | DESCRIBE } [ TABLE ] [ EXTENDED | FORMATTED ] table_name { [ PARTITION clause ] | [ column_name ] }
Parametrar
EXTENDEDEllerFORMATTEDOm det anges visas detaljerad information om de angivna kolumnerna, inklusive kolumnstatistiken som samlas in av kommandot, och ytterligare metadatainformation (till exempel schemakvalificerare, ägare och åtkomsttid).
-
Identifierar den tabell som ska beskrivas. Namnet får inte använda en temporal specifikation. Om det inte går att hitta tabellen genererar Azure Databricks ett TABLE_OR_VIEW_NOT_FOUND fel.
-
En valfri parameter som dirigerar Databricks SQL för att returnera tilläggsmetadata för de namngivna partitionerna.
-
En valfri parameter med kolumnnamnet som måste beskrivas. För närvarande tillåts inte kapslade kolumner att anges.
Parametrar partition_spec och column_name är ömsesidigt uteslutande och kan inte anges tillsammans.
Exempel
-- 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
BESKRIV DETALJER
DESCRIBE DETAIL [schema_name.]table_name
DESCRIBE DETAIL delta.`<path-to-table>`
Returnera information om schema, partitionering, tabellstorlek och så vidare. För Delta-tabeller kan du till exempel se de aktuella läsar- och skrivarversionerna av en tabell. Se Granska Delta Lake-tabellinformation med beskrivande information för informationsschemat.