DESCRIBE DATABASE
描述
DESCRIBE DATABASE
语句返回一个已存在的数据库的元数据。元数据信息包括数据库名称、数据库注释和数据库在系统上的位置。
如果指定了可选的 EXTENDED
选项,则返回基本元数据信息以及数据库属性。DATABASE
、 NAMESPACE
和 SCHEMA
是可互换的。
语法
{ DESC | DESCRIBE } { DATABASE | SCHEMA | NAMESPACE } [ EXTENDED ] db_name
参数
db_name
指定一个已存在的数据库的名称。如果名称不存在,则引发异常。
示例
-- 创建数据库 employees
CREATE DATABASE employees COMMENT 'For software companies';
-- 描述数据库 employees
-- 返回目录名称、数据库名称、描述和位置
DESCRIBE DATABASE employees;
+--------------+----------------------+
| info_name| info_value|
+--------------+----------------------+
| Catalog Name| spark_catalog|
|Namespace Name| employees|
| Comment|For software companies|
| Location| employees.db|
+--------------+----------------------+
-- 使用 EXTENDED 选项描述数据库 employees,用来返回数据库属性
DESCRIBE DATABASE EXTENDED employees;
+--------------+----------------------+
| info_name| info_value|
+--------------+----------------------+
| Catalog Name| spark_catalog|
|Namespace Name| employees|
| Comment|For software companies|
| Location| employees.db|
| Properties| |
+--------------+----------------------+