Skip to main content
Edit this page

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