TABLOYU AÇıKLAMA
Şunun için geçerlidir:
Databricks SQL denetimi yes Databricks Runtime
Tablonun temel meta veri bilgilerini döndürür. Meta veri bilgileri sütun adını, sütun türünü ve sütun açıklamasını içerir. İsteğe bağlı olarak, sırasıyla bir bölüm veya sütunla ilgili meta verileri döndürmek için bölüm belirtimi veya sütun adı belirtebilirsiniz. Delta tablolarında tüm alanlar döndürülmüyor.
Sözdizimi
{ DESC | DESCRIBE } [ TABLE ] [ EXTENDED | FORMATTED ] table_name { [ PARTITION clause ] | [ column_name ] }
Parametre
EXTENDEDVeyaFORMATTEDBelirtilen durumlarda, komut tarafından toplanan sütun istatistikleri ve ek meta veri bilgileri (şema niteleyicisi, sahip ve erişim süresi gibi) dahil olmak üzere belirtilen sütunlar hakkında ayrıntılı bilgiler görüntülenir.
-
Açıklanacak tabloyu tanımlar. Ad geçici belirtim kullanmayabilir. Tablo bulunamazsa Azure Databricks TABLE_OR_VIEW_NOT_FOUND hatası oluşturur.
-
Databricks SQL'i adlandırılmış bölümler için ek meta veriler döndürmeye yönlendiren isteğe bağlı bir parametre.
-
Açıklanması gereken sütun adına sahip isteğe bağlı bir parametre. Şu anda iç içe geçmiş sütunların belirtilmesine izin verilmiyor.
ve parametreleri partition_speccolumn_name birbirini dışlar ve birlikte belirtilemez.
Örnekler
-- 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
AYRINTIYI ANLATIN
DESCRIBE DETAIL [schema_name.]table_name
DESCRIBE DETAIL delta.`<path-to-table>`
Şema, bölümleme, tablo boyutu vb. hakkında bilgi döndürür. Örneğin, Delta tabloları için tablonun geçerli okuyucu ve yazıcı sürümlerini görebilirsiniz. Ayrıntı şeması için açıklama ayrıntılarıyla delta Lake tablosu ayrıntılarını gözden geçirme bölümüne bakın.