CREATE DATABASE

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

​

Секции

​

IF NOT EXISTS

• Не генерирует исключение, если указана эта конструкция.
• Генерирует исключение, если эта конструкция не указана.

​

ON CLUSTER

​

ДВИЖОК

​

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

​

SETTINGS

​

disk

CREATE DATABASE db_name SETTINGS disk = 'db_disk';
CREATE DATABASE db_name SETTINGS disk = disk(type = 'local', path = '/var/lib/clickhouse-disks/db_disk');

​

lazy_load_tables

CREATE DATABASE db_name ENGINE = Atomic SETTINGS lazy_load_tables = 1;

• Пока к таблице не обратились, system.tables показывает её движок как TableProxy. После первого обращения отображается реальное имя движка (например, MergeTree).
• Столбцы вроде total_rows и total_bytes возвращают NULL для незагруженных таблиц, поскольку реальное хранилище ещё не создано.

• SELECT, INSERT, ALTER, DROP прозрачно инициируют загрузку реального движка таблицы при первом использовании.
• RENAME TABLE работает без инициирования загрузки.
• После загрузки таблица остаётся загруженной на всё время работы серверного процесса.

• Инструменты мониторинга, которые полагаются на метаданные system.tables (например, total_rows, engine), могут показывать неполную информацию для незагруженных таблиц.
• Первый запрос к незагруженной таблице приводит к разовым затратам на загрузку (разбор сохранённого оператора CREATE TABLE и инициализацию движка).