更新时间:2026-11-06 GMT+08:00
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' );
父主题: DDL语句