SHOW TABLE EXTENDED

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime

显示与给定正则表达式匹配的所有 tables 的信息。 输出包括基本的 table 信息和文件系统信息,如 Last AccessCreated ByTypeProviderTable PropertiesLocationSerde LibraryInputFormatOutputFormatStorage PropertiesPartition ProviderPartition ColumnsSchema

如果存在 partition 规范,它将输出给定 partition文件系统特定的信息,例如 Partition ParametersPartition Statistics。 不能将 table 正则表达式与 partition 规范一起使用。

注意

为了与 Apache Spark 兼容,此命令使用 Apache Spark 表示法呈现 tablecolumn 类型。 语言映射中描述了到 SQL 的映射。 检索 tablecolumn 信息的其他方式为 DESCRIBE TABLE,以及在 Unity CatalogINFORMATION_SCHEMA.COLUMNS 上。

语法

SHOW TABLE EXTENDED [ { IN | FROM } schema_name ] LIKE regex_pattern
    [ PARTITION clause ]

Parameters

  • schema_name

    指定 schema 名称。 如果未提供,请使用当前 schema。

  • regex_pattern

    用于筛除不需要的 tables 的正则表达式模式。

    • *| 字符外,该模式的工作方式类似于正则表达式。
    • 只有 * 则匹配 0 个或多个字符,| 用于分隔多个不同的正则表达式,其中任何一个表达式都可以匹配。
    • 在处理前,在输入模式中删除前导空格和尾随空格。 模式匹配不区分大小写。
  • PARTITION 子句

    (可选)指定分区。 不能将 table 正则表达式模式与 PARTITION 子句一起使用。

示例

-- Assumes `employee` table partitioned by column `grade`
> CREATE TABLE employee(name STRING, grade INT) PARTITIONED BY (grade);
> INSERT INTO employee PARTITION (grade = 1) VALUES ('sam');
> INSERT INTO employee PARTITION (grade = 2) VALUES ('suj');

-- Show the details of the table

> SHOW TABLE EXTENDED LIKE 'employee';
 database tableName isTemporary                          information
 -------- --------- ----------- --------------------------------------------------------------
 default  employee  false       Database: default
                                Table: employee
                                Owner: root
                                Created Time: Fri Aug 30 15:10:21 IST 2019
                                Last Access: Thu Jan 01 05:30:00 IST 1970
                                Created By: Spark 3.0.0
                                Type: MANAGED
                                Provider: hive
                                Table Properties: [transient_lastDdlTime=1567158021]
                                Location: file:/opt/spark1/spark/spark-warehouse/employee
                                Serde Library: org.apache.hadoop.hive.serde2.lazy
                                .LazySimpleSerDe
                                InputFormat: org.apache.hadoop.mapred.TextInputFormat
                                OutputFormat: org.apache.hadoop.hive.ql.io
                                .HiveIgnoreKeyTextOutputFormat
                                Storage Properties: [serialization.format=1]
                                Partition Provider: Catalog
                                Partition Columns: [`grade`]
                                Schema: root
                                  -- name: string (nullable = true)
                                  -- grade: integer (nullable = true)

-- show multiple table details with pattern matching
> SHOW TABLE EXTENDED  LIKE 'employe*';
 database tableName isTemporary                          information
 -------- --------- ----------- --------------------------------------------------------------
 default  employee  false       Database: default
                                Table: employee
                                Owner: root
                                Created Time: Fri Aug 30 15:10:21 IST 2019
                                Last Access: Thu Jan 01 05:30:00 IST 1970
                                Created By: Spark 3.0.0
                                Type: MANAGED
                                Provider: hive
                                Table Properties: [transient_lastDdlTime=1567158021]
                                Location: file:/opt/spark1/spark/spark-warehouse/employee
                                Serde Library: org.apache.hadoop.hive.serde2.lazy
                                .LazySimpleSerDe
                                InputFormat: org.apache.hadoop.mapred.TextInputFormat
                                OutputFormat: org.apache.hadoop.hive.ql.io
                                .HiveIgnoreKeyTextOutputFormat
                                Storage Properties: [serialization.format=1]
                                Partition Provider: Catalog
                                Partition Columns: [`grade`]
                                Schema: root
                                  -- name: string (nullable = true)
                                  -- grade: integer (nullable = true)

 default  employee1 false       Database: default
                                Table: employee1
                                Owner: root
                                Created Time: Fri Aug 30 15:22:33 IST 2019
                                Last Access: Thu Jan 01 05:30:00 IST 1970
                                Created By: Spark 3.0.0
                                Type: MANAGED
                                Provider: hive
                                Table Properties: [transient_lastDdlTime=1567158753]
                                Location: file:/opt/spark1/spark/spark-warehouse/employee1
                                Serde Library: org.apache.hadoop.hive.serde2.lazy
                                .LazySimpleSerDe
                                InputFormat: org.apache.hadoop.mapred.TextInputFormat
                                OutputFormat: org.apache.hadoop.hive.ql.io
                                .HiveIgnoreKeyTextOutputFormat
                                Storage Properties: [serialization.format=1]
                                Partition Provider: Catalog
                                Schema: root
                                  -- name: string (nullable = true)

-- show partition file system details
> SHOW TABLE EXTENDED  IN default LIKE 'employee' PARTITION (grade = 1);
 database tableName isTemporary                          information
 -------- --------- ----------- --------------------------------------------------------------
 default  employee  false       Partition Values: [grade=1]
                                Location: file:/opt/spark1/spark/spark-warehouse/employee
                                /grade=1
                                Serde Library: org.apache.hadoop.hive.serde2.lazy
                                .LazySimpleSerDe
                                InputFormat: org.apache.hadoop.mapred.TextInputFormat
                                OutputFormat: org.apache.hadoop.hive.ql.io
                                .HiveIgnoreKeyTextOutputFormat
                                Storage Properties: [serialization.format=1]
                                Partition Parameters: {rawDataSize=-1, numFiles=1,
                                transient_lastDdlTime=1567158221, totalSize=4,
                                COLUMN_STATS_ACCURATE=false, numRows=-1}
                                Created Time: Fri Aug 30 15:13:41 IST 2019
                                Last Access: Thu Jan 01 05:30:00 IST 1970
                                Partition Statistics: 4 bytes

-- show partition file system details with regex fail
> SHOW TABLE EXTENDED  IN default LIKE 'empl*' PARTITION (grade = 1);
 Error: TABLE_OR_VIEW_NOT_FOUND