# CREATE DATABASE
在Doris数据管理场景中，数据库（Database）是数据组织和管理的顶层容器，用于对表、视图等数据库对象进行逻辑分组和权限管理。在实际业务中，不同部门、项目或业务线的数据需要进行隔离管理，通过创建独立的数据库可以实现数据隔离和权限控制。CREATE DATABASE语句用于在Doris集群中创建新的数据库，是数据管理的基础操作。
本文介绍CREATE DATABASE的语法、参数说明和使用示例。
#### 基本语法
CREATE DATABASE语句的基本语法如下：
**CREATE DATABASE \[IF NOT EXISTS\]** *db_name*
**\[PROPERTIES ("** *key* **"="** *value* **", ...)\];**
表1CREATE DATABASE参数说明 
| 参数            | 说明                                                                     |
|:---|:---|
| IF NOT EXISTS | 【可选】该参数用于指定在数据库已存在时是否报错。如果指定该子句，当数据库已存在时不会报错，而是静默返回；如果不指定，当数据库已存在时会报错。 |
| db_name       | 该参数用于指定要创建的数据库名称。数据库名称必须唯一，不能与已存在的数据库重名。数据库名称区分大小写。                    |
| PROPERTIES    | 【可选】该参数用于设置数据                                                          |
   
#### 约束与限制
- 数据库名称区分大小写，例如"example_db"和"EXAMPLE_DB"被视为不同的数据库。
- 数据库名称不能与已存在的数据库重名，除非使用IF NOT EXISTS子句。
- 创建数据库需要具有相应的权限，普通用户需要被授予CREATE DATABASE权限。
- Doris系统内置数据库不能被删除或修改。
 
#### 前提条件
- 已创建包含Doris服务的集群，集群内各服务运行正常。
- 已安装MySQL客户端。了解如何使用MySQL客户端连接Doris，请参考[使用MySQL客户端连接Doris](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_249271.html)。
- 已创建具有Doris管理权限的用户。
 
#### 使用示例
1. 使用具有Doris管理权限的用户通过MySQL客户端连接到Doris。
2. 执行以下命令创建数据库**example_db** ：
   
   ```
   create database if not exists example_db;
   ```
   
   
3. 执行以下命令查看数据库信息，确认数据库创建成功。 
   ```
   SHOW DATABASES;
   ```
   ```
   +--------------------+
   | Database           |
   +--------------------+
   | example_db         |
   | information_schema |
   +--------------------+
   2 rows in set (0.00 sec)
   ```
   
   
4. 执行以下命令切换到**example_db** ，以便在该数据库中创建表。
   
   ```
   use example_db;
   ```
   
   
**验证操作：**
执行SHOW DATABASES;命令，确认新数据库已出现在列表中。
#### 常见问题
- **创建数据库时报权限不足**
  当前用户没有被授予CREATE DATABASE权限。
  请联系管理员为该用户授予CREATE DATABASE权限，或使用具有管理员权限的用户创建数据库。
  
- **数据库名称已存在**
  要创建的数据库名称与已存在的数据库重名。
  如果希望数据库已存在时不报错，请在CREATE DATABASE语句中使用IF NOT EXISTS子句。或者使用其他数据库名称。
  
 
#### 相关文档
- 了解如何使用MySQL客户端连接Doris，请参考[使用MySQL客户端连接Doris](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_249271.html)。
- 了解如何创建Doris表，请参考[CREATE TABLE](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_249197.html)。
- 了解如何删除Doris表，请参考[DROP TABLE](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_249200.html)。
- 了解快速使用Doris，请参考[快速使用Doris](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_249185.html)。