2020-03-20 18:20:59 +00:00
# Запросы SYSTEM {#query-language-system}
2019-07-10 07:04:53 +00:00
2020-03-21 04:11:51 +00:00
- [RELOAD DICTIONARIES ](#query_language-system-reload-dictionaries )
- [RELOAD DICTIONARY ](#query_language-system-reload-dictionary )
- [DROP DNS CACHE ](#query_language-system-drop-dns-cache )
- [DROP MARK CACHE ](#query_language-system-drop-mark-cache )
- [FLUSH LOGS ](#query_language-system-flush_logs )
- [RELOAD CONFIG ](#query_language-system-reload-config )
- [SHUTDOWN ](#query_language-system-shutdown )
- [KILL ](#query_language-system-kill )
- [STOP DISTRIBUTED SENDS ](#query_language-system-stop-distributed-sends )
- [FLUSH DISTRIBUTED ](#query_language-system-flush-distributed )
- [START DISTRIBUTED SENDS ](#query_language-system-start-distributed-sends )
- [STOP MERGES ](#query_language-system-stop-merges )
- [START MERGES ](#query_language-system-start-merges )
2019-07-10 07:04:53 +00:00
2020-03-22 09:14:59 +00:00
## RELOAD DICTIONARIES {#query_language-system-reload-dictionaries}
2019-09-06 20:40:50 +00:00
2020-03-20 18:20:59 +00:00
Перегружает все словари, которые были успешно загружены до этого.
2020-04-30 18:19:18 +00:00
По умолчанию включена ленивая загрузка [dictionaries\_lazy\_load ](../../sql-reference/statements/system.md#dictionaries-lazy-load ), поэтому словари не загружаются автоматически при старте, а только при первом обращении через dictGet или SELECT к ENGINE=Dictionary. После этого такие словари (LOADED) будут перегружаться командой `system reload dictionaries` .
2019-09-06 20:56:39 +00:00
Всегда возвращает `Ok.` , вне зависимости от результата обновления словарей.
2019-09-06 20:40:50 +00:00
2020-04-30 18:19:18 +00:00
## RELOAD DICTIONARY Dictionary\_name {#query_language-system-reload-dictionary}
2019-09-06 20:40:50 +00:00
2020-03-20 18:20:59 +00:00
Полностью перегружает словарь `dictionary_name` , вне зависимости от состояния словаря (LOADED/NOT\_LOADED/FAILED).
2019-09-06 20:56:39 +00:00
Всегда возвращает `Ok.` , вне зависимости от результата обновления словаря.
2019-09-06 20:40:50 +00:00
Состояние словаря можно проверить запросом к `system.dictionaries` .
2020-03-20 18:20:59 +00:00
``` sql
2019-09-09 18:35:41 +00:00
SELECT name, status FROM system.dictionaries;
2019-09-06 20:40:50 +00:00
```
2020-03-22 09:14:59 +00:00
## DROP DNS CACHE {#query_language-system-drop-dns-cache}
2019-09-06 20:40:50 +00:00
2019-09-09 23:41:03 +00:00
Сбрасывает внутренний DNS кеш ClickHouse. Иногда (для старых версий ClickHouse) необходимо использовать эту команду при изменении инфраструктуры (смене IP адреса у другого ClickHouse сервера или сервера, используемого словарями).
2019-09-06 20:40:50 +00:00
2020-03-20 18:20:59 +00:00
Для более удобного (автоматического) управления кешем см. параметры disable\_internal\_dns\_cache, dns\_cache\_update\_period.
2019-09-06 20:40:50 +00:00
2020-03-22 09:14:59 +00:00
## DROP MARK CACHE {#query_language-system-drop-mark-cache}
2019-09-06 20:40:50 +00:00
2020-03-20 18:20:59 +00:00
Сбрасывает кеш «засечек» (`mark cache`). Используется при разработке ClickHouse и тестах производительности.
2019-09-06 20:40:50 +00:00
2020-03-22 09:14:59 +00:00
## FLUSH LOGS {#query_language-system-flush_logs}
2019-09-06 20:40:50 +00:00
2020-03-20 18:20:59 +00:00
Записывает буферы логов в системные таблицы (например system.query\_log). Позволяет не ждать 7.5 секунд при отладке.
2019-09-06 20:40:50 +00:00
2020-03-22 09:14:59 +00:00
## RELOAD CONFIG {#query_language-system-reload-config}
2019-09-06 20:40:50 +00:00
Перечитывает конфигурацию настроек ClickHouse. Используется при хранении конфигурации в zookeeeper.
2020-03-22 09:14:59 +00:00
## SHUTDOWN {#query_language-system-shutdown}
2019-09-06 20:40:50 +00:00
Штатно завершает работу ClickHouse (аналог `service clickhouse-server stop` / `kill {$pid_clickhouse-server}` )
2020-03-22 09:14:59 +00:00
## KILL {#query_language-system-kill}
2019-09-06 20:40:50 +00:00
Аварийно завершает работу ClickHouse (аналог `kill -9 {$pid_clickhouse-server}` )
2020-03-20 18:20:59 +00:00
## Управление распределёнными таблицами {#query-language-system-distributed}
2019-07-10 07:04:53 +00:00
2020-04-30 18:19:18 +00:00
ClickHouse может оперировать [распределёнными ](../../sql-reference/statements/system.md ) таблицами. Когда пользователь вставляет данные в эти таблицы, ClickHouse сначала формирует очередь из данных, которые должны быть отправлены на узлы кластера, а затем асинхронно отправляет подготовленные данные. Вы можете управлять очередью с помощью запросов [STOP DISTRIBUTED SENDS ](#query_language-system-stop-distributed-sends ), [START DISTRIBUTED SENDS ](#query_language-system-start-distributed-sends ) и [FLUSH DISTRIBUTED ](#query_language-system-flush-distributed ). Также есть возможность синхронно вставлять распределенные данные с помощью настройки `insert_distributed_sync` .
2019-07-10 07:04:53 +00:00
2020-03-22 09:14:59 +00:00
### STOP DISTRIBUTED SENDS {#query_language-system-stop-distributed-sends}
2019-07-10 07:04:53 +00:00
2019-08-14 07:58:30 +00:00
Отключает фоновую отправку при вставке данных в распределённые таблицы.
2019-07-10 07:04:53 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2019-07-10 07:04:53 +00:00
SYSTEM STOP DISTRIBUTED SENDS [db.]< distributed_table_name >
```
2020-03-22 09:14:59 +00:00
### FLUSH DISTRIBUTED {#query_language-system-flush-distributed}
2019-07-10 07:04:53 +00:00
2019-08-14 07:58:30 +00:00
В синхронном режиме отправляет все данные на узлы кластера. Если какие-либо узлы недоступны, ClickHouse генерирует исключение и останавливает выполнение запроса. Такой запрос можно повторять до успешного завершения, что будет означать возвращение связанности с остальными узлами кластера.
2019-07-10 07:04:53 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2019-07-10 07:04:53 +00:00
SYSTEM FLUSH DISTRIBUTED [db.]< distributed_table_name >
```
2020-03-22 09:14:59 +00:00
### START DISTRIBUTED SENDS {#query_language-system-start-distributed-sends}
2019-07-10 07:04:53 +00:00
2019-08-14 07:58:30 +00:00
Включает фоновую отправку при вставке данных в распределенные таблицы.
2019-07-10 07:04:53 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2019-07-10 07:04:53 +00:00
SYSTEM START DISTRIBUTED SENDS [db.]< distributed_table_name >
```
2019-08-14 07:58:30 +00:00
2020-03-22 09:14:59 +00:00
### STOP MERGES {#query_language-system-stop-merges}
2019-11-01 08:45:09 +00:00
2019-11-01 14:27:59 +00:00
Позволяет остановить фоновые мержи для таблиц семейства MergeTree:
2019-11-01 08:45:09 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2019-11-01 14:17:49 +00:00
SYSTEM STOP MERGES [[db.]merge_tree_family_table_name]
2019-11-01 08:45:09 +00:00
```
2020-03-20 18:20:59 +00:00
2019-11-22 13:02:33 +00:00
!!! note "Note"
2019-11-01 14:27:36 +00:00
`DETACH / ATTACH` таблицы восстанавливает фоновые мержи для этой таблицы (даже в случае отключения фоновых мержей для всех таблиц семейства MergeTree до `DETACH` ).
2019-11-01 08:45:09 +00:00
2020-03-22 09:14:59 +00:00
### START MERGES {#query_language-system-start-merges}
2019-11-01 14:17:49 +00:00
2019-11-01 14:27:20 +00:00
Включает фоновые мержи для таблиц семейства MergeTree:
2019-11-01 08:45:09 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2019-11-01 14:17:49 +00:00
SYSTEM START MERGES [[db.]merge_tree_family_table_name]
2019-11-01 08:45:09 +00:00
```
2020-01-30 10:34:55 +00:00
[Оригинальная статья ](https://clickhouse.tech/docs/ru/query_language/system/ ) <!--hide-->