跳至主要内容

CREATE DATABASE

创建新的数据库。

CREATE DATABASE [IF NOT EXISTS] db_name [ON CLUSTER cluster] [ENGINE = engine(...)] [COMMENT 'Comment']

子句​

IF NOT EXISTS​

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

  • 如果指定了该子句，则不会抛出异常。
  • 如果没有指定该子句，则会抛出异常。

ON CLUSTER​

ClickHouse 在指定集群的所有服务器上创建 db_name 数据库。更多详细信息请参见 分布式 DDL 文章。

ENGINE​

默认情况下，ClickHouse 使用其自身的 Atomic 数据库引擎。还有 Lazy、MySQL、PostgresSQL、MaterializedMySQL、MaterializedPostgreSQL、Replicated、SQLite。

COMMENT​

您可以在创建数据库时添加注释。

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

语法

CREATE DATABASE db_name ENGINE = engine(...) COMMENT 'Comment'

示例

查询

CREATE DATABASE db_comment ENGINE = Memory COMMENT 'The temporary database';
SELECT name, comment FROM system.databases WHERE name = 'db_comment';

结果

┌─name───────┬─comment────────────────┐
│ db_comment │ The temporary database │
└────────────┴────────────────────────┘