SHOW SCHEMAS

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime

Lists the schemas that match an optionally supplied regular expression pattern. If no pattern is supplied then the command lists all the schemas in the system.

While usage of SCHEMAS and DATABASES is interchangeable, SCHEMAS is preferred.

Syntax 

SHOW SCHEMAS [ [ LIKE ] regex_pattern ]

Parameters

  • regex_pattern

    A regular expression pattern that is used to filter the results of the statement. - Except for * and | character, the pattern works like a regular expression. - * alone matches 0 or more characters and | is used to separate multiple different regular expressions, any of which can match. - The leading and trailing blanks are trimmed in the input pattern before processing. The pattern match is case-insensitive.

Examples 

-- Create schema. Assumes a schema named `default` already exists in
-- the system.
> CREATE SCHEMA payroll_sc;
> CREATE SCHEMA payments_sc;

-- Lists all the schemas.
> SHOW SCHEMAS;
 databaseName
 ------------
      default
  payments_sc
   payroll_sc

-- Lists schemas with name starting with string pattern `pay`
> SHOW SCHEMAS LIKE 'pay*';
 databaseName
 ------------
  payments_sc
   payroll_sc

-- Lists all schemas. Keywords SCHEMAS and DATABASES are interchangeable.
> SHOW SCHEMAS;
 databaseName
 ------------
      default
  payments_sc
   payroll_sc