跳到主要内容
跳到主要内容

CREATE DATABASE

创建新数据库。

CREATE DATABASE [IF NOT EXISTS] 数据库名 [ON CLUSTER 集群] [ENGINE = 引擎(...)] [COMMENT '备注']

子句

IF NOT EXISTS

如果 db_name 数据库已经存在,则 ClickHouse 不会创建新的数据库,并且:

  • 如果指定了该子句,则不会抛出异常。
  • 如果未指定该子句,则会抛出异常。

ON CLUSTER

ClickHouse 会在指定集群的所有服务器上创建 db_name 数据库。更多详情参见 Distributed DDL 一文。

ENGINE

默认情况下,ClickHouse 使用其自带的 Atomic 数据库引擎。还可以使用 LazyMySQLPostgresSQLMaterializedPostgreSQLReplicatedSQLite

COMMENT

在创建数据库时,可以为其添加注释。

所有数据库引擎都支持注释。

语法

CREATE DATABASE db_name ENGINE = engine(...) COMMENT '注释'

示例

查询:

CREATE DATABASE db_comment ENGINE = Memory COMMENT '临时数据库';
SELECT name, comment FROM system.databases WHERE name = 'db_comment';

结果:

┌─name───────┬─comment────────────────┐
│ db_comment │ 临时数据库             │
└────────────┴────────────────────────┘