Partager via


DESCRIBE SCHEMA

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

Retourne les métadonnées d’un schéma existant. Les informations des métadonnées incluent le nom, le commentaire et l’emplacement du schéma sur le système de fichiers. Si l’option facultative EXTENDED est spécifiée, les propriétés de schéma sont également retournées.

Bien que SCHEMA et DATABASE soient interchangeables, il est préférable d’utiliser SCHEMA.

Syntaxe

{ DESC | DESCRIBE } SCHEMA [ EXTENDED ] schema_name

Paramètres

  • schema_name : nom d’un schéma existant (schéma) dans le système. Si le nom n’existe pas, une exception est levée.

Exemples

-- Create employees SCHEMA
> CREATE SCHEMA employees COMMENT 'For software companies';

-- Describe employees SCHEMA.
-- Returns Database Name, Description and Root location of the filesystem
-- for the employees SCHEMA.
> DESCRIBE SCHEMA employees;
 database_description_item    database_description_value
 ------------------------- -----------------------------
             Database Name                     employees
               Description        For software companies
                  Location file:/you/Temp/employees.db

-- Create employees SCHEMA
> CREATE SCHEMA employees COMMENT 'For software companies';

-- Alter employees schema to set DBPROPERTIES
> ALTER SCHEMA employees SET DBPROPERTIES ('Create-by' = 'Kevin', 'Create-date' = '09/01/2019');

-- Describe employees SCHEMA with EXTENDED option to return additional schema properties
> DESCRIBE SCHEMA EXTENDED employees;
 database_description_item                    database_description_value
 ------------------------- ---------------------------------------------
             Database Name                                     employees
               Description                        For software companies
                  Location                 file:/you/Temp/employees.db
                Properties ((Create-by,kevin), (Create-date,09/01/2019))

-- Create deployment SCHEMA
> CREATE SCHEMA deployment COMMENT 'Deployment environment';

-- Describe deployment.
> DESCRIBE SCHEMA deployment;
 database_description_item database_description_value
 ------------------------- ------------------------------
             Database Name                     deployment
               Description         Deployment environment
                  Location file:/you/Temp/deployment.db