Partager via


SHOW TABLE EXTENDED

S’applique à : case marquée oui Databricks SQL case marquée oui Databricks Runtime

Affiche des informations pour toutes les tables correspondant à l’expression régulière donnée. La sortie contient des informations de base sur les tables et des informations sur le système de fichiers, telles que Last Access, Created By, Type, Provider, Table Properties, Location, Serde Library, InputFormat, OutputFormat, Storage Properties, Partition Provider, Partition Columns et Schema.

Si une spécification de partition est présente, elle génère les informations spécifiques au système de fichiers de la partition donnée, telles que Partition Parameters et Partition Statistics. Vous ne pouvez pas utiliser une expression régulière de table avec une spécification de partition.

Remarque

Pour assurer la compatibilité avec Apache Spark, cette commande restitue les types de colonne de table à l'aide de la notation Apache Spark. Le mappage vers SQL est décrit dans Mappages de langage. D'autres façons de récupérer les informations de colonne de table sont DESCRIBE TABLE, et sur Unity Catalog INFORMATION_SCHEMA.COLUMNS.

Syntaxe

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

Paramètres

  • schema_name

    Spécifie le nom du schéma. S’il n’est pas fourni, utilise le schéma actuel.

  • regex_pattern

    Modèle d’expression régulière utilisé pour filtrer les tables indésirables.

    • À l’exception des caractères * et |, le modèle fonctionne comme une expression régulière.
    • * seul correspond à 0 ou plusieurs caractères et | est utilisé pour séparer plusieurs expressions régulières différentes, qui peuvent toutes correspondre.
    • Les espaces de début et de fin sont supprimés dans le modèle d’entrée avant le traitement. La correspondance du modèle n’est pas sensible à la casse.
  • Clause PARTITION

    (Facultatif) Spécification des partitions. Vous ne pouvez pas utiliser un modèle d’expression régulière de table avec une clause PARTITION.

Exemples

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