Compartilhar via


SHOW TABLE EXTENDED

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva Runtime do Databricks

Mostra informações de todas as tabelas que correspondam à expressão regular fornecida. A saída inclui informações básicas de tabela e informações do sistema de arquivos, como Last Access, Created By, Type, Provider, Table Properties, Location, Serde Library, InputFormat, OutputFormat, Storage Properties, Partition Provider, Partition Columns e Schema.

Caso uma especificação de partição esteja presente, ela gerará as informações específicas do sistema de arquivos da partição fornecida, como Partition Parameters e Partition Statistics. Não é possível usar uma expressão regular de tabela com uma especificação de partição.

Observação

Para compatibilidade com o Apache Spark, esse comando renderiza os tipos de coluna da tabela usando a notação do Apache Spark. O mapeamento para SQL está descrito em Mapeamentos de linguagem. Outras formas de recuperar as informações das colunas da tabela são DESCRIBE TABLE e, no Catálogo do Unity, INFORMATION_SCHEMA.COLUMNS.

Sintaxe

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

Parâmetros

  • schema_name

    Especifica o nome do esquema. Se não for fornecido, o esquema atual será usado.

  • regex_pattern

    O padrão de expressão regular usado para filtrar tabelas não desejadas.

    • Com exceção dos caracteres * e |, ele funciona como uma expressão regular.
    • * só corresponde a zero ou mais caracteres e | é usado para separar várias expressões regulares diferentes, que podem corresponder.
    • Os espaços em branco à esquerda e à direita são cortados no padrão de entrada antes do processamento. A correspondência de padrões não diferencia maiúsculas de minúsculas.
  • Cláusula PARTITION

    Especificando partições como opção. Você não pode usar um padrão regex de tabela com uma cláusula PARTITION.

Exemplos

-- 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