Перейти к основному содержанию
Перейти к основному содержанию

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 'Комментарий'

Пример

Запрос:

CREATE DATABASE db_comment ENGINE = Memory COMMENT 'Временная база данных';
SELECT name, comment FROM system.databases WHERE name = 'db_comment';

Результат:

┌─name───────┬─comment────────────────┐
│ db_comment │ Временная база данных  │
└────────────┴────────────────────────┘