DESCRIBE DATABASE (Databricks SQL)

Devuelve los metadatos de una base de datos existente. La información de metadatos incluye el nombre de la base de datos, el comentario de base de datos y la ubicación de la base de datos en el sistema de archivos. Si se especifica la opción opcional, devuelve la información de metadatos EXTENDED básica junto con las propiedades de la base de datos. y DATABASE SCHEMA son intercambiables.

Sintaxis

{ DESC | DESCRIBE } DATABASE [ EXTENDED ] database_name

Parámetros

  • database_name: nombre de una base de datos existente (esquema) en el sistema. Si el nombre no existe, se produce una excepción.

Ejemplos

-- Create employees DATABASE
CREATE DATABASE employees COMMENT 'For software companies';

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

-- Create employees DATABASE
CREATE DATABASE employees COMMENT 'For software companies';

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

-- Describe employees DATABASE with EXTENDED option to return additional database properties
DESCRIBE DATABASE 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, the DATABASE and SCHEMA are interchangeable, your meaning are the same.
DESC DATABASE deployment;
+-------------------------+------------------------------+
|database_description_item|database_description_value    |
+-------------------------+------------------------------+
|            Database Name|                    deployment|
|              Description|        Deployment environment|
|                 Location|file:/you/Temp/deployment.db  |
+-------------------------+------------------------------+