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 データベースを作成します。詳細は Distributed DDL の記事を参照してください。

ENGINE

デフォルトでは、ClickHouse は独自の Atomic データベースエンジンを使用します。このほかに、Lazy、MySQL、PostgresSQL、MaterializedPostgreSQL、Replicated、SQLite があります。

COMMENT

データベースを作成する際に、コメントを追加できます。

コメント指定は、すべてのデータベースエンジンでサポートされています。

構文

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

例

クエリ:

CREATE DATABASE db_comment ENGINE = Memory COMMENT '一時データベース';
SELECT name, comment FROM system.databases WHERE name = 'db_comment';

結果:

┌─name───────┬─comment────────────────┐
│ db_comment │ 一時データベース       │
└────────────┴────────────────────────┘