
# 查看指定数据库
#### 功能描述
返回指定数据库的元数据信息，包括数据库名称、数据库描述、文件系统上的存储路径等。如果指定EXTENDED选项，还会返回数据库的属性信息。
#### 语法格式
```
DESCRIBE DATABASE [EXTENDED] db_name;
```
#### 关键字
EXTENDED：除了显示上述信息外，还会额外显示数据库的属性（DBPROPERTIES）信息。
#### 参数说明
表1参数说明 
| **参数**  | **描述**                                  |
|:---|:---|
| 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/    |
   
