更新时间：2026-07-03 GMT+08:00
查看指定数据库
功能描述
返回指定数据库的元数据信息，包括数据库名称、数据库描述、文件系统上的存储路径等。如果指定EXTENDED选项，还会返回数据库的属性信息。
语法格式
1 | DESCRIBE DATABASE [EXTENDED] db_name; |
关键字
EXTENDED：除了显示上述信息外，还会额外显示数据库的属性（DBPROPERTIES）信息。
参数说明
| 参数 | 描述 |
|---|---|
| db_name | 数据库名称，由字母、数字和下划线组成。不能是纯数字，且不能以数字和下划线开头。 |
注意事项
- 如果所要查看的数据库不存在，则系统报错。
- EXTENDED选项会额外显示DBPROPERTIES中定义的属性信息。
- DESC与DESCRIBE等效，可替换使用。
- DATABASE与SCHEMA等效，可替换使用。
示例1：查看数据库基本信息
查看employees数据库的名称、描述和存储路径。
DESCRIBE DATABASE employees;
结果示例：
| database_description_item | database_description_value |
|---|---|
| Database Name | employees |
| Description | For software companies |
| Location | obs://my-bucket/employees/ |
示例2：查看数据库详细信息（含属性）
使用EXTENDED选项查看数据库的属性信息。
DESCRIBE DATABASE EXTENDED employees;
结果示例：
| database_description_item | database_description_value |
|---|---|
| Database Name | employees |
| Description | For software companies |
| Location | obs://my-bucket/employees/ |
| Properties | ((Create-by,kevin), (Create-date,09/01/2019)) |
示例3：使用DESC简写
DESC是DESCRIBE的简写形式。
DESC DATABASE employees;
示例4：查看使用SCHEMA关键字创建的数据库
DATABASE与SCHEMA等效。
DESC DATABASE deployment;
结果示例：
| database_description_item | database_description_value |
|---|---|
| Database Name | deployment |
| Description | Deployment environment |
| Location | obs://my-bucket/deployment/ |
父主题： 数据库相关
