DESCRIBE TABLE
Область применения: Databricks SQL Databricks Runtime
Возвращает основные сведения о метаданных для таблицы. Сведения о метаданных содержат имя столбца, тип столбца и комментарий к столбцу. При необходимости можно указать спецификацию секции или имя столбца, чтобы вернуть метаданные, относящиеся к секции или столбцу соответственно. При использовании разностных таблиц возвращаются не все поля.
Синтаксис
{ DESC | DESCRIBE } [ TABLE ] [ EXTENDED | FORMATTED ] table_name { [ PARTITION clause ] | [ column_name ] }
Параметры
EXTENDED
илиFORMATTED
Если значение указано, отображает подробные сведения об указанных столбцах, включая собранную командой статистику по столбцам и дополнительные сведения о метаданных (квалификатор схемы, владелец, время доступа и так далее).
-
Определяет таблицу, которую нужно описать. Имя может не использовать темпоральную спецификацию или спецификацию параметров. Если не удается найти таблицу Azure Databricks, возникает ошибка TABLE_OR_VIEW_NOT_FOUND .
-
Необязательный параметр, при наличии которого Databricks SQL будет возвращать дополнительные метаданные для именованных секций.
-
Необязательный параметр с именем столбца, который нужно описать. В настоящее время здесь не допускается указывать вложенные столбцы.
Параметры partition_spec
и column_name
являются взаимоисключающими, то есть не могут использоваться вместе.
Примеры
-- 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
Возвращает сведения о схеме, секционировании, размере таблицы и т. д. Например, для таблиц Delta можно узнать текущие версии модуля чтения и записи таблицы. Ознакомьтесь с подробными сведениями о таблице Delta Lake с подробными сведениями о схеме сведений.