DESCRIBE TABLE
Gilt für: 
Databricks SQL Databricks Runtime
Gibt die grundlegenden Metadateninformationen einer Tabelle zurück. Die Metadateninformationen enthalten den Spaltennamen, Spaltentyp und Spaltenkommentar. Optional können Sie eine Partitionsspezifikation oder einen Spaltennamen angeben, um die zu einer Partition bzw. Spalte gehörenden Metadaten zurückzugeben. Bei Delta-Tabellen werden nicht alle Felder zurückgegeben.
Syntax
{ DESC | DESCRIBE } [ TABLE ] [ EXTENDED | FORMATTED ] table_name { [ PARTITION clause ] | [ column_name ] }
Parameter
EXTENDEDoderFORMATTEDFalls angegeben, werden detaillierte Informationen zu den angegebenen Spalten angezeigt, einschließlich der vom Befehl gesammelten Spaltenstatistiken und zusätzlicher Metadateninformationen (z. B. Schemaqualifizierer, Besitzer und Zugriffszeit).
-
Gibt die zu beschreibende Tabelle an. Der Name darf keine zeitliche Spezifikation oder Optionsspezifikation verwenden. Wenn die Tabelle nicht gefunden werden kann, löst Azure Databricks den Fehler TABLE_OR_VIEW_NOT_FOUND aus.
-
Ein optionaler Parameter, der Databricks SQL anweist, zusätzliche Metadaten für die benannten Partitionen zurückzugeben.
-
Ein optionaler Parameter mit dem Namen der Spalte, die beschrieben werden muss. Derzeit dürfen geschachtelte Spalten nicht angegeben werden.
Die Parameter partition_spec und column_name schließen sich gegenseitig aus und können nicht zusammen angegeben werden.
Beispiele
-- 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
DESCRIBE DETAIL
DESCRIBE DETAIL [schema_name.]table_name
Gibt Informationen zu Schema, Partitionierung, Tabellengröße usw. zurück. Bei Delta-Tabellen können Sie zum Beispiel die aktuellen Reader- und Writer-Versionen einer Tabelle einsehen. Weitere Informationen zum Detailschema finden Sie unter Überprüfen der Details der Delta Lake-Tabelle mit „describe detail“.