DESCRIBE TABLE
Se aplica a:
Databricks SQL Databricks Runtime
Devuelve la información básica de metadatos de una tabla. La información de metadatos incluye el nombre de columna, el tipo de columna y el comentario de columna. Opcionalmente, puede especificar una especificación de partición o nombre de columna para devolver los metadatos que pertenecen a una partición o columna, respectivamente. Con las tablas Delta, no se devuelven todos los campos.
Sintaxis
{ DESC | DESCRIBE } [ TABLE ] [ EXTENDED | FORMATTED ] table_name { [ PARTITION clause ] | [ column_name ] }
Parámetros
EXTENDEDoFORMATTEDSi se especifica, se muestra información detallada sobre las columnas especificadas, incluidas las estadísticas de columna recopiladas por el comando, y la información de metadatos adicional (como el calificador de esquema, el propietario y la hora de acceso).
-
Identifica la tabla que se va a describir. Es posible que el nombre no use una especificación temporal o una especificación de opciones. Si no se encuentra la tabla, Azure Databricks genera un error TABLE_OR_VIEW_NOT_FOUND.
-
Parámetro opcional que dirige a Databricks SQL para devolver metadatos adicionales para las particiones con nombre.
-
Un parámetro opcional con el nombre de columna que debe describirse. Actualmente no se pueden especificar columnas anidadas.
Los parámetros partition_spec y column_name se excluyen mutuamente y no se pueden especificar juntos.
Ejemplos
-- 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
Devuelve información sobre el esquema, la creación de particiones, el tamaño de la tabla, etc. Por ejemplo, en el caso de las tablas Delta, puede ver las versiones actuales de lector y escritor de una tabla. Consulte Revisión de los detalles de la tabla de Delta Lake con describe detail para obtener el esquema detallado.