DESCRIBE DATABASE

Devolve os metadados de uma base de dados existente. As informações de metadados incluem nome de base de dados, comentário de base de dados e localização da base de dados no sistema de ficheiros. Se a opção opcional EXTENDED for especificada, devolve as informações básicas de metadados juntamente com as propriedades da base de dados. O DATABASE e SCHEMA são permutáveis.

Sintaxe

{ DESC | DESCRIBE } DATABASE [ EXTENDED ] db_name

Parâmetros

  • db_name: O nome de uma base de dados existente ou de um esquema existente no sistema. Se o nome não existir, uma exceção é lançada.

Exemplos

-- 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  |
+-------------------------+------------------------------+