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

Atomic

Движок Atomic поддерживает неблокирующие DROP TABLE и RENAME TABLE запросы, а также атомарные EXCHANGE TABLES запросы. Движок базы данных Atomic используется по умолчанию.

примечание

В ClickHouse Cloud по умолчанию используется движок базы данных Replicated.

Создание базы данных

Специфика и рекомендации

UUID таблицы

Каждая таблица в базе данных Atomic имеет постоянный UUID и хранит свои данные в следующем каталоге:

Где xxxyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy — это UUID таблицы.

По умолчанию UUID генерируется автоматически. Однако пользователи могут явно указать UUID при создании таблицы, хотя это не рекомендуется.

Например:

примечание

Вы можете использовать настройку show_table_uuid_in_table_create_query_if_not_nil, чтобы отображать UUID с запросом SHOW CREATE.

RENAME TABLE

Запросы RENAME не изменяют UUID и не перемещают данные таблицы. Эти запросы выполняются немедленно и не ждут завершения других запросов, которые используют таблицу.

DROP/DETACH TABLE

При использовании DROP TABLE данные не удаляются. Движок Atomic просто помечает таблицу как удалённую, перемещая её метаданные в /clickhouse_path/metadata_dropped/ и уведомляя фоновый поток. Задержка перед окончательным удалением данных таблицы задаётся настройкой database_atomic_delay_before_drop_table_sec. Вы можете указать синхронный режим с помощью модификатора SYNC. Для этого используйте настройку database_atomic_wait_for_drop_and_detach_synchronously. В этом случае DROP будет ожидать завершения выполняющихся SELECT, INSERT и других запросов, использующих таблицу. Таблица будет удалена, когда она не используется.

EXCHANGE TABLES/DICTIONARIES

Запрос EXCHANGE атомарно меняет местами таблицы или словари. Например, вместо этой неатомарной операции:

вы можете использовать атомарную:

ReplicatedMergeTree в атомарной базе данных

Для таблиц ReplicatedMergeTree рекомендуется не указывать параметры движка для пути в ZooKeeper и имени реплики. В этом случае будут использоваться параметры конфигурации default_replica_path и default_replica_name. Если вы хотите явно указать параметры движка, рекомендуется использовать макрос {uuid}. Это обеспечит автоматическую генерацию уникальных путей для каждой таблицы в ZooKeeper.

См. также