更新时间：2026-08-20 GMT+08:00

CREATE DATABASE

在Doris数据管理场景中，数据库（Database）是数据组织和管理的顶层容器，用于对表、视图等数据库对象进行逻辑分组和权限管理。在实际业务中，不同部门、项目或业务线的数据需要进行隔离管理，通过创建独立的数据库可以实现数据隔离和权限控制。CREATE DATABASE语句用于在Doris集群中创建新的数据库，是数据管理的基础操作。

本文介绍CREATE DATABASE的语法、参数说明和使用示例。

基本语法

CREATE DATABASE语句的基本语法如下：

CREATE DATABASE [IF NOT EXISTS] db_name

[PROPERTIES ("key"="value", ...)];

表1 CREATE DATABASE参数说明
参数	说明
IF NOT EXISTS	【可选】该参数用于指定在数据库已存在时是否报错。如果指定该子句，当数据库已存在时不会报错，而是静默返回；如果不指定，当数据库已存在时会报错。
db_name	该参数用于指定要创建的数据库名称。数据库名称必须唯一，不能与已存在的数据库重名。数据库名称区分大小写。
PROPERTIES	【可选】该参数用于设置数据

约束与限制

数据库名称区分大小写，例如“example_db”和“EXAMPLE_DB”被视为不同的数据库。
数据库名称不能与已存在的数据库重名，除非使用IF NOT EXISTS子句。
创建数据库需要具有相应的权限，普通用户需要被授予CREATE DATABASE权限。
Doris系统内置数据库不能被删除或修改。

前提条件

已创建包含Doris服务的集群，集群内各服务运行正常。
已安装MySQL客户端。了解如何使用MySQL客户端连接Doris，请参考使用MySQL客户端连接Doris。
已创建具有Doris管理权限的用户。

使用示例

使用具有Doris管理权限的用户通过MySQL客户端连接到Doris。
执行以下命令创建数据库example_db：
```
create database if not exists example_db;
```

执行以下命令查看数据库信息，确认数据库创建成功。

SHOW DATABASES;

+--------------------+
| Database           |
+--------------------+
| example_db         |
| information_schema |
+--------------------+
2 rows in set (0.00 sec)

执行以下命令切换到example_db，以便在该数据库中创建表。
```
use example_db;
```

验证操作：

执行SHOW DATABASES;命令，确认新数据库已出现在列表中。

常见问题

创建数据库时报权限不足
当前用户没有被授予CREATE DATABASE权限。

请联系管理员为该用户授予CREATE DATABASE权限，或使用具有管理员权限的用户创建数据库。
数据库名称已存在
要创建的数据库名称与已存在的数据库重名。

如果希望数据库已存在时不报错，请在CREATE DATABASE语句中使用IF NOT EXISTS子句。或者使用其他数据库名称。