Skip to main content

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 │
└────────────┴────────────────────────┘