# CREATE DATABASE
#### 概述
CREATE DATABASE语句用于在当前或指定Catalog中创建数据库。数据库是Catalog下的命名空间，用于组织和管理表、视图、函数等对象。创建数据库后可通过USE语句切换到该数据库进行后续操作。
#### 适用场景
- **项目隔离**：为不同项目或业务域创建独立数据库，实现数据逻辑隔离。
- **环境管理**：为开发、测试、生产等不同环境分别创建数据库。
- **权限分区**：通过数据库级别划分访问权限，控制不同用户的数据可见范围。
 
#### 约束与限制
- 数据库名在同一个Catalog内必须唯一，重复创建需使用IF NOT EXISTS。
- WITH子句中可设置的属性取决于Catalog实现，不同Catalog支持的属性不同。
- 数据库只能在当前Catalog下创建，不支持跨Catalog创建。
- 删除数据库前需确保数据库内无表或其他对象，或使用CASCADE级联删除。
 
#### 语法结构
```
CREATE DATABASE [IF NOT EXISTS] [catalog_name.]db_name
[COMMENT database_comment]
WITH (key1=val1, key2=val2, ...)
```
#### 语法说明
| **参数**        | **必填** | **说明**                              |
|:---|:---|:---|
| IF NOT EXISTS | 否      | 指定当同名数据库已存在时不报错。未指定时若同名数据库存在则抛出异常。  |
| catalog_name  | 否      | 指定目标Catalog名称。省略时使用当前Catalog。       |
| db_name       | 是      | 数据库名称，在Catalog内必须唯一。命名建议使用小写字母和下划线。 |
| COMMENT       | 否      | 数据库的注释说明，便于理解数据库用途和所属业务。            |
| WITH          | 否      | 以键值对形式设置数据库级别属性。具体可用属性取决于Catalog实现。 |
   
#### 使用示例
**示例1：创建数据库**
```
CREATE DATABASE IF NOT EXISTS mydb COMMENT 'AI DataLake业务数据库';
```
**示例2：带WITH属性创建paimon数据库**
```
CREATE DATABASE IF NOT EXISTS paimon_db
COMMENT 'paimon元数据数据库'
WITH (
 'location' = 'obs://bucket/path/paimon-warehouse/paimon_db'
);
```
