SYSTEM RELOAD EMBEDDED DICTIONARIES
Ok. независимо от результата обновления встроенных словарей.
SYSTEM RELOAD DICTIONARIES
SYSTEM RELOAD DICTIONARIES перезагружает словари со status LOADED (см. столбец status в system.dictionaries), то есть словари, которые ранее уже были успешно загружены.
По умолчанию словари загружаются лениво (см. dictionaries_lazy_load), поэтому вместо автоматической загрузки при запуске они инициализируются при первом обращении — через функцию dictGet или при выполнении SELECT из таблиц с ENGINE = Dictionary.
Синтаксис
SYSTEM RELOAD DICTIONARIES [ON CLUSTER cluster_name]
dictionary_name независимо от его состояния (LOADED / NOT_LOADED / FAILED).
Всегда возвращает Ok. независимо от результата обновления словаря.
SYSTEM RELOAD DICTIONARY [ON CLUSTER cluster_name] dictionary_name
system.dictionaries.
SELECT name, status FROM system.dictionaries;
Этот оператор и SYSTEM RELOAD MODEL лишь выгружают модели CatBoost из clickhouse-library-bridge. Функция catboostEvaluate()
загружает модель при первом обращении, если она ещё не загружена.
SYSTEM RELOAD MODELS [ON CLUSTER cluster_name]
model_path.
Синтаксис
SYSTEM RELOAD MODEL [ON CLUSTER cluster_name] <model_path>
SYSTEM RELOAD FUNCTIONS [ON CLUSTER cluster_name]
SYSTEM RELOAD FUNCTION [ON CLUSTER cluster_name] function_name
SYSTEM RELOAD ASYNCHRONOUS METRICS
SYSTEM RELOAD ASYNCHRONOUS METRICS [ON CLUSTER cluster_name]
SYSTEM CLEAR|DROP DNS CACHE
disable_internal_dns_cache, dns_cache_max_entries, dns_cache_update_period.
SYSTEM CLEAR|DROP MARK CACHE
SYSTEM CLEAR|DROP AVRO SCHEMA CACHE
AvroConfluent. Эта команда удаляет как кэш получения схем (id → схема), так и кэш регистрации схем (subject + схема → id), поэтому последующие операции чтения и записи снова будут обращаться к серверу Schema Registry. Полезно, если схема была удалена или перезаписана на стороне реестра, а также для проверки идемпотентности реестра в тестах.
Очищает кэш метаданных Parquet.
SYSTEM CLEAR|DROP TEXT INDEX CACHES
SYSTEM CLEAR TEXT INDEX HEADER CACHE,SYSTEM CLEAR TEXT INDEX DICTIONARY CACHE илиSYSTEM CLEAR TEXT INDEX POSTINGS CACHE
Недоступные реплики таблиц ReplicatedMergeTree можно удалить с помощью следующего синтаксиса:
SYSTEM DROP REPLICA 'replica_name' FROM TABLE database.table;
SYSTEM DROP REPLICA 'replica_name' FROM DATABASE database;
SYSTEM DROP REPLICA 'replica_name';
SYSTEM DROP REPLICA 'replica_name' FROM ZKPATH '/path/to/table/in/zk';
ReplicatedMergeTree в ZooKeeper. Это полезно, когда реплика недоступна, а ее метаданные невозможно удалить из ZooKeeper с помощью DROP TABLE, потому что такой таблицы уже не существует. Удалить можно только неактивную/устаревшую реплику; локальную реплику удалить нельзя, для этого используйте DROP TABLE. DROP REPLICA не удаляет никаких таблиц и не удаляет с диска ни данные, ни метаданные.
Первый удаляет метаданные реплики 'replica_name' таблицы database.table.
Второй делает то же самое для всех реплицируемых таблиц в базе данных.
Третий делает то же самое для всех реплицируемых таблиц на локальном сервере.
Четвертый полезен для удаления метаданных недоступной реплики, когда все остальные реплики таблицы были удалены. Для него нужно явно указать путь к таблице. Это должен быть тот же путь, который был передан в качестве первого аргумента движка ReplicatedMergeTree при создании таблицы.
SYSTEM DROP DATABASE REPLICA
Replicated можно удалить с помощью следующего синтаксиса:
SYSTEM DROP DATABASE REPLICA 'replica_name' [FROM SHARD 'shard_name'] FROM DATABASE database;
SYSTEM DROP DATABASE REPLICA 'replica_name' [FROM SHARD 'shard_name'];
SYSTEM DROP DATABASE REPLICA 'replica_name' [FROM SHARD 'shard_name'] FROM ZKPATH '/path/to/table/in/zk';
SYSTEM DROP REPLICA, удаляет путь реплики базы данных Replicated из ZooKeeper, если базы данных, для которой можно выполнить DROP DATABASE, больше нет. Обратите внимание: эта команда не удаляет реплики ReplicatedMergeTree (поэтому вам также может понадобиться SYSTEM DROP REPLICA). Имена сегмента и реплики — это имена, указанные в аргументах движка Replicated при создании базы данных. Кроме того, эти имена можно получить из столбцов database_shard_name и database_replica_name в system.clusters. Если предложение FROM SHARD отсутствует, то replica_name должно быть полным именем реплики в формате shard_name|replica_name.
SYSTEM CLEAR|DROP UNCOMPRESSED CACHE
use_uncompressed_cache.
Его размер можно задать с помощью настройки уровня сервера uncompressed_cache_size.
SYSTEM CLEAR|DROP COMPILED EXPRESSION CACHE
compile_expressions.
SYSTEM CLEAR|DROP QUERY CONDITION CACHE
SYSTEM CLEAR|DROP КЭШ ЗАПРОСОВ
SYSTEM CLEAR QUERY CACHE;
SYSTEM CLEAR QUERY CACHE TAG '<tag>'
format_schema_path.
Поддерживаемые цели:
- Protobuf: удаляет импортированные определения сообщений Protobuf из памяти.
- Files: удаляет кэшированные файлы схем, хранящиеся локально в
format_schema_path и создаваемые, когда format_schema_source имеет значение query.
Примечание: если цель не указана, очищаются оба кэша.
SYSTEM CLEAR|DROP FORMAT SCHEMA CACHE [FOR Protobuf/Files]
system.query_log. В основном полезно для отладки, поскольку для большинства системных таблиц интервал сброса по умолчанию составляет 7,5 секунды.
Также создаёт системные таблицы, даже если очередь сообщений пуста.
SYSTEM FLUSH LOGS [ON CLUSTER cluster_name] [log_name|[database.table]] [, ...]
SYSTEM FLUSH LOGS query_log, system.query_views_log;
SYSTEM RELOAD CONFIG не перезагружает конфигурацию USER, хранящуюся в ZooKeeper: эта команда перезагружает только конфигурацию USER, которая хранится в users.xml. Чтобы перезагрузить всю конфигурацию USER, используйте SYSTEM RELOAD USERS
SYSTEM RELOAD CONFIG [ON CLUSTER cluster_name]
SYSTEM RELOAD USERS [ON CLUSTER cluster_name]
service clickhouse-server stop / kill {$pid_clickhouse-server})
Завершает процесс ClickHouse (как kill -9 {$ pid_clickhouse-server})
Управляет точками инструментирования с помощью возможности XRay в LLVM, доступной при сборке ClickHouse с ENABLE_XRAY=1.
Это позволяет выполнять отладку и профилирование в продакшне без изменения исходного кода и с минимальными накладными расходами.
Если не добавлена ни одна точка инструментирования, потери производительности пренебрежимо малы, поскольку добавляется лишь дополнительный переход на ближайший
адрес в прологе и эпилоге тех функций, которые длиннее 200 инструкций.
Добавляет новую точку инструментирования. Функции, для которых включено инструментирование, можно просматривать в системной таблице system.instrumentation. Для одной и той же функции можно добавить несколько обработчиков, и они будут выполняться в порядке добавления.
Функции для инструментирования можно получить из системной таблицы system.symbols.
Существует три типа обработчиков, которые можно добавить к функциям:
Синтаксис
SYSTEM INSTRUMENT ADD FUNCTION HANDLER [PARAMETERS]
FUNCTION — это любая функция или её подстрока, например QueryMetricLog::startQuery, а обработчик — один из следующих
Выводит текст, переданный в качестве аргумента, и трассировку стека при ENTRY или EXIT функции.
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' LOG ENTRY 'this is a log printed at entry'
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' LOG EXIT 'this is a log printed at exit'
ENTRY, либо при EXIT:
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' SLEEP ENTRY 0.5
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' SLEEP ENTRY 0 1
ENTRY и EXIT при выполнении функции.
Результат профилирования сохраняется в system.trace_log и может быть преобразован
в формат трассировки событий Chrome.
SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' PROFILE
SYSTEM INSTRUMENT REMOVE ID
ALL:
SYSTEM INSTRUMENT REMOVE ALL
SYSTEM INSTRUMENT REMOVE (SELECT id FROM system.instrumentation WHERE handler = 'log')
SYSTEM INSTRUMENT REMOVE 'QueryMetricLog::startQuery'
system.instrumentation.
Управление distributed таблицами
STOP DISTRIBUTED SENDS, FLUSH DISTRIBUTED и START DISTRIBUTED SENDS. Вы также можете синхронно вставлять распределённые данные с помощью настройки distributed_foreground_insert.
SYSTEM STOP DISTRIBUTED SENDS
SYSTEM STOP DISTRIBUTED SENDS [db.]<distributed_table_name> [ON CLUSTER cluster_name]
SETTINGS; это может быть полезно, чтобы обойти временные ограничения, например max_concurrent_queries_for_all_users или max_memory_usage.
SYSTEM FLUSH DISTRIBUTED [db.]<distributed_table_name> [ON CLUSTER cluster_name] [SETTINGS ...]
Каждый блок, ожидающий отправки, хранится на диске с настройками из исходного запроса INSERT, поэтому иногда может понадобиться переопределить эти настройки.
SYSTEM START DISTRIBUTED SENDS
SYSTEM START DISTRIBUTED SENDS [db.]<distributed_table_name> [ON CLUSTER cluster_name]
SYSTEM STOP LISTEN [ON CLUSTER cluster_name] [QUERIES ALL | QUERIES DEFAULT | QUERIES CUSTOM | TCP | TCP WITH PROXY | TCP SECURE | HTTP | HTTPS | MYSQL | GRPC | POSTGRESQL | PROMETHEUS | CUSTOM 'protocol']
- Если указан модификатор
CUSTOM 'protocol', будет остановлен пользовательский протокол с указанным именем, определённый в разделе protocols конфигурации сервера.
- Если указан модификатор
QUERIES ALL [EXCEPT .. [,..]], будут остановлены все протоколы, кроме указанных в предложении EXCEPT.
- Если указан модификатор
QUERIES DEFAULT [EXCEPT .. [,..]], будут остановлены все протоколы по умолчанию, кроме указанных в предложении EXCEPT.
- Если указан модификатор
QUERIES CUSTOM [EXCEPT .. [,..]], будут остановлены все пользовательские протоколы, кроме указанных в предложении EXCEPT.
Позволяет устанавливать новые соединения по указанным протоколам.
Однако если сервер на указанном порту и по указанному протоколу не был остановлен с помощью команды SYSTEM STOP LISTEN, эта команда не возымеет никакого эффекта.
SYSTEM START LISTEN [ON CLUSTER cluster_name] [QUERIES ALL | QUERIES DEFAULT | QUERIES CUSTOM | TCP | TCP WITH PROXY | TCP SECURE | HTTP | HTTPS | MYSQL | GRPC | POSTGRESQL | PROMETHEUS | CUSTOM 'protocol']
Управление таблицами MergeTree
SYSTEM STOP MERGES [ON CLUSTER cluster_name] [ON VOLUME <volume_name> | [db.]merge_tree_family_table_name]
DETACH / ATTACH для таблицы запустит фоновые слияния, даже если ранее они были остановлены для всех таблиц MergeTree.
SYSTEM START MERGES [ON CLUSTER cluster_name] [ON VOLUME <volume_name> | [db.]merge_tree_family_table_name]
Ok. даже если таблица не существует или не использует движок MergeTree. Возвращает ошибку, если база данных не существует:
SYSTEM STOP TTL MERGES [ON CLUSTER cluster_name] [[db.]merge_tree_family_table_name]
Ok. даже если таблица не существует. Возвращает ошибку, если база данных не существует:
SYSTEM START TTL MERGES [ON CLUSTER cluster_name] [[db.]merge_tree_family_table_name]
Ok., даже если таблица не существует. Возвращает ошибку, если база данных не существует:
SYSTEM STOP MOVES [ON CLUSTER cluster_name] [[db.]merge_tree_family_table_name]
Ok. даже если таблица не существует. Возвращает ошибку, если база данных не существует:
SYSTEM START MOVES [ON CLUSTER cluster_name] [[db.]merge_tree_family_table_name]
SYSTEM UNFREEZE WITH NAME <backup_name>
SYSTEM WAIT LOADING PARTS
SYSTEM WAIT LOADING PARTS [ON CLUSTER cluster_name] [db.]merge_tree_family_table_name
Управление таблицами ReplicatedMergeTree
ReplicatedMergeTree:
Всегда возвращает Ok. независимо от движка таблицы, даже если таблица или база данных не существуют.
SYSTEM STOP FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
ReplicatedMergeTree:
Всегда возвращает Ok. независимо от движка таблицы, даже если таблица или база данных не существуют.
SYSTEM START FETCHES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM STOP REPLICATED SENDS
ReplicatedMergeTree:
SYSTEM STOP REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM START REPLICATED SENDS
ReplicatedMergeTree на другие реплики в кластере:
SYSTEM START REPLICATED SENDS [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM STOP REPLICATION QUEUES
ReplicatedMergeTree. Возможные типы фоновых задач: слияние, загрузка, мутация, DDL-операторы с предложением ON CLUSTER:
SYSTEM STOP REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM START REPLICATION QUEUES
ReplicatedMergeTree. Возможные типы фоновых задач — слияния, загрузки, мутации, DDL-операторы с предложением ON CLUSTER:
SYSTEM START REPLICATION QUEUES [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM STOP PULLING REPLICATION LOG
ReplicatedMergeTree.
SYSTEM STOP PULLING REPLICATION LOG [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
SYSTEM START PULLING REPLICATION LOG
SYSTEM STOP PULLING REPLICATION LOG.
SYSTEM START PULLING REPLICATION LOG [ON CLUSTER cluster_name] [[db.]replicated_merge_tree_family_table_name]
ReplicatedMergeTree синхронизируется с другими репликами в кластере, но не дольше receive_timeout секунд.
SYSTEM SYNC REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name [IF EXISTS] [STRICT | LIGHTWEIGHT [FROM 'srcReplica1'[, 'srcReplica2'[, ...]]] | PULL]
[db.]replicated_merge_tree_family_table_name получает команды из общего журнала репликации в свою очередь репликации, а затем запрос ждёт, пока реплика не обработает все полученные команды. Поддерживаются следующие модификаторы:
- С
IF EXISTS (доступно начиная с 25.6) запрос не сгенерирует ошибку, если таблица не существует. Это полезно при добавлении новой реплики в кластер, когда она уже входит в конфигурацию кластера, но таблица для неё всё ещё создаётся и синхронизируется.
- Если указан модификатор
STRICT, запрос ждёт, пока очередь репликации не опустеет. Вариант STRICT может так и не завершиться успешно, если в очереди репликации постоянно появляются новые записи.
- Если указан модификатор
LIGHTWEIGHT, запрос ждёт только обработки записей GET_PART, ATTACH_PART, DROP_RANGE, REPLACE_RANGE и DROP_PART.
Кроме того, модификатор LIGHTWEIGHT поддерживает необязательное выражение FROM ‘srcReplicas’, где ‘srcReplicas’ — это список имён исходных реплик, разделённых запятыми. Это расширение позволяет точнее настраивать синхронизацию, ограничивая её задачами репликации только от указанных исходных реплик.
- Если указан модификатор
PULL, запрос получает новые записи очереди репликации из ZooKeeper, но не ждёт их обработки.
Ожидает, пока указанная база данных Replicated не применит все изменения схемы из очереди DDL этой базы данных.
Синтаксис
SYSTEM SYNC DATABASE REPLICA replicated_database_name;
ReplicatedMergeTree: текущее состояние будет сверено с ZooKeeper как с источником истины, и при необходимости в очередь ZooKeeper будут добавлены задачи.
Инициализация очереди репликации на основе данных ZooKeeper выполняется так же, как и для оператора ATTACH TABLE. На короткое время таблица будет недоступна для выполнения любых операций.
SYSTEM RESTART REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
ReplicatedMergeTree в режиме только для чтения.
Запрос можно выполнить после:
- Потери корневого пути ZooKeeper
/.
- Потери пути реплик
/replicas.
- Потери пути отдельной реплики
/replicas/replica_name/.
Реплика подключает найденные локально части и отправляет информацию о них в ZooKeeper.
Части, присутствовавшие на реплике до потери метаданных, не загружаются повторно с других реплик, если они не устарели (то есть восстановление реплики не означает повторную загрузку всех данных по сети).
Части во всех состояниях перемещаются в папку detached/. Части, которые были активны до потери данных (committed), подключаются.
SYSTEM RESTORE DATABASE REPLICA
SYSTEM RESTORE DATABASE REPLICA repl_db [ON CLUSTER cluster]
CREATE DATABASE repl_db
ENGINE=Replicated("/clickhouse/repl_db", shard1, replica1);
CREATE TABLE repl_db.test_table (n UInt32)
ENGINE = ReplicatedMergeTree
ORDER BY n PARTITION BY n % 10;
-- zookeeper_delete_path("/clickhouse/repl_db", recursive=True) <- потеря корневого узла.
SYSTEM RESTORE DATABASE REPLICA repl_db;
SYSTEM RESTORE REPLICA [db.]replicated_merge_tree_family_table_name [ON CLUSTER cluster_name]
SYSTEM RESTORE REPLICA [ON CLUSTER cluster_name] [db.]replicated_merge_tree_family_table_name
CREATE TABLE test(n UInt32)
ENGINE = ReplicatedMergeTree('/clickhouse/tables/test/', '{replica}')
ORDER BY n PARTITION BY n % 10;
INSERT INTO test SELECT * FROM numbers(1000);
-- zookeeper_delete_path("/clickhouse/tables/test", recursive=True) <- потеря корня.
SYSTEM RESTART REPLICA test;
SYSTEM RESTORE REPLICA test;
SYSTEM RESTORE REPLICA test ON CLUSTER cluster;
ReplicatedMergeTree, сравнивает текущее состояние с ZooKeeper как с источником истины и при необходимости добавляет задачи в очередь ZooKeeper
SYSTEM CLEAR|DROP FILESYSTEM CACHE
SYSTEM CLEAR FILESYSTEM CACHE [ON CLUSTER cluster_name]
Это слишком затратная операция и может использоваться не по назначению.
SYSTEM SYNC FILE CACHE [ON CLUSTER cluster_name]
SYSTEM LOAD PRIMARY KEY [db.]name
SYSTEM UNLOAD PRIMARY KEY
SYSTEM UNLOAD PRIMARY KEY [db.]name
SYSTEM UNLOAD PRIMARY KEY
Управление Refreshable Materialized Views
system.view_refreshes.
SYSTEM STOP [REPLICATED] VIEW, STOP VIEWS
STOP VIEW действует только на текущую реплику, а STOP REPLICATED VIEW — на все реплики.
Состояние остановки не сохраняется после перезапуска сервера. После перезапуска представления возобновят обновление в соответствии с настроенным для них расписанием.
В базах данных Replicated или Shared SYSTEM STOP VIEW действует только на текущую реплику. Чтобы остановить обновления на всех репликах, используйте SYSTEM STOP REPLICATED VIEW.
SYSTEM STOP VIEW [db.]name
SYSTEM START [REPLICATED] VIEW, START VIEWS
START VIEW отменяет действие STOP VIEW, а START REPLICATED VIEW — действие STOP REPLICATED VIEW. START VIEW также отменяет действие PAUSE VIEW.
SYSTEM START VIEW [db.]name
SYSTEM PAUSE VIEW, PAUSE VIEWS
SYSTEM STOP VIEW, команда SYSTEM PAUSE VIEW не прерывает уже выполняющееся обновление: текущему обновлению даётся завершиться, а предотвращаются только последующие обновления.
Отменить это действие можно с помощью SYSTEM START VIEW или SYSTEM START VIEWS.
Состояние паузы не сохраняется после перезапуска сервера. После перезапуска представления возобновят обновление по настроенному расписанию.
В базах данных Replicated или Shared команда SYSTEM PAUSE VIEW влияет только на текущую реплику.
SYSTEM PAUSE VIEW [db.]name
SYSTEM REFRESH VIEW [db.]name
SYSTEM WAIT VIEW [db.]name
SYSTEM CANCEL VIEW [db.]name
SYSTEM FLUSH OBJECT STORAGE QUEUE
SYSTEM FLUSH OBJECT STORAGE QUEUE [db.]table_name PATH 'path'
Последнее изменение 10 июня 2026 г.
