SHOW TABLES (Databricks SQL)

Retourne toutes les tables pour un schéma facultativement spécifié. En outre, la sortie de cette instruction peut être filtrée par un modèle de correspondance facultatif. Si aucun schéma n’est spécifié, les tables sont retournées à partir du schéma actuel.

Syntaxe

SHOW TABLES [ { FROM | IN } schema_name ] [ LIKE regex_pattern ]

Paramètres

  • schema_name

    Spécifie le nom du schéma à partir duquel les tables doivent être listées. S’il n’est pas fourni, utilise le schéma actuel.

  • regex_pattern

    Modèle d’expression régulière qui est 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.

Exemples

-- List all tables in default schema
> SHOW TABLES;
 database tableName isTemporary
 -------- --------- -----------
  default       sam       false
  default      sam1       false
  default       suj       false

-- List all tables from usersc schema
> SHOW TABLES FROM usersc;
 database tableName isTemporary
 -------- --------- -----------
   usersc     user1       false
   usersc     user2       false

-- List all tables in usersc schema
> SHOW TABLES IN usersc;
 database tableName isTemporary
 -------- --------- -----------
   usersc     user1       false
   usersc     user2       false

-- List all tables from default schema matching the pattern `sam*`
> SHOW TABLES FROM default LIKE 'sam*';
 database tableName isTemporary
 -------- --------- -----------
  default       sam       false
  default      sam1       false

-- List all tables matching the pattern `sam*|suj`
> SHOW TABLES LIKE 'sam*|suj';
 database tableName isTemporary
 -------- --------- -----------
  default       sam       false
  default      sam1       false
  default       suj       false