更新时间: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'
);

相关文档