DESCRIÇÃO DO ESQUEMA
Aplica-se a: SQL do Databricks Runtime do Databricks
Retorna os metadados de um esquema existente.
As informações de metadados incluem o nome, o comentário e o local do esquema no sistema de arquivos.
Se, opcionalmente, você especificar a opção EXTENDED
, as propriedades do esquema também serão retornadas.
Embora o uso de SCHEMA
e DATABASE
seja intercambiável, SCHEMA
é preferencial.
Sintaxe
{ DESC | DESCRIBE } SCHEMA [ EXTENDED ] schema_name
Parâmetros
- schema_name: o nome de um esquema (schema) existente no sistema. Se o nome não existir, será gerada uma exceção.
Exemplos
-- 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