diff --git a/docs/en/query_language/system.md b/docs/en/query_language/system.md index c5f4830723f..b7797df490b 100644 --- a/docs/en/query_language/system.md +++ b/docs/en/query_language/system.md @@ -4,31 +4,36 @@ - [FLUSH DISTRIBUTED](#query_language-system-flush-distributed) - [START DISTRIBUTED SENDS](#query_language-system-start-distributed-sends) + ## Managing Distributed Tables {#query_language-system-distributed} -ClickHouse can manage [distributed](../operations/table_engines/distributed.md) tables. When a user inserts data into such table, ClickHouse creates a queue of the data which should be sent to servers of the cluster, then asynchronously sends them. You can control the processing of queue by using the requests [STOP DISTRIBUTED SENDS](#query_language-system-stop-distributed-sends), [FLUSH DISTRIBUTED](#query_language-system-flush-distributed) and [START DISTRIBUTED SENDS](#query_language-system-start-distributed-sends). Also, you can synchronously insert distributed data with the `insert_distributed_sync` setting. +ClickHouse can manage [distributed](../operations/table_engines/distributed.md) tables. When a user inserts data into these tables, ClickHouse first creates a queue of the data that should be sent to cluster nodes, then asynchronously sends it. You can manage queue processing with the [STOP DISTRIBUTED SENDS](#query_language-system-stop-distributed-sends), [FLUSH DISTRIBUTED](#query_language-system-flush-distributed), and [START DISTRIBUTED SENDS](#query_language-system-start-distributed-sends) queries. You can also synchronously insert distributed data with the `insert_distributed_sync` setting. ### STOP DISTRIBUTED SENDS {#query_language-system-stop-distributed-sends} -Disables background data distributing, when inserting data into the distributed tables. +Disables background data distribution when inserting data into distributed tables. -``` +```sql SYSTEM STOP DISTRIBUTED SENDS [db.] ``` + ### FLUSH DISTRIBUTED {#query_language-system-flush-distributed} -Forces ClickHouse to send data to the servers of the cluster in synchronous mode. If some of the servers are not available, ClickHouse throws an exception and stops query processing. When servers are back into operation, you should repeat the query. +Forces ClickHouse to send data to cluster nodes synchronously. If any nodes are unavailable, ClickHouse throws an exception and stops query execution. You can retry the query until it succeeds, which will happen when all nodes are back online. -``` +```sql SYSTEM FLUSH DISTRIBUTED [db.] ``` + ### START DISTRIBUTED SENDS {#query_language-system-start-distributed-sends} -Enables background data distributing, when inserting data into the distributed tables. +Enables background data distribution when inserting data into distributed tables. -``` +```sql SYSTEM START DISTRIBUTED SENDS [db.] ``` + +[Original article](https://clickhouse.yandex/docs/en/query_language/system/) diff --git a/docs/ru/query_language/system.md b/docs/ru/query_language/system.md index fcf6fb8eced..f35b4a39061 100644 --- a/docs/ru/query_language/system.md +++ b/docs/ru/query_language/system.md @@ -1,16 +1,16 @@ -# SYSTEM Queries {#query_language-system} +# Запросы SYSTEM {#query_language-system} - [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) -## Managing Distributed Tables {#query_language-system-distributed} +## Управление распределёнными таблицами {#query_language-system-distributed} -ClickHouse can manage [distributed](../operations/table_engines/distributed.md) tables. When a user inserts data into such table, ClickHouse creates a queue of the data which should be sent to servers of the cluster, then asynchronously sends them. You can control the processing of queue by using the requests [STOP DISTRIBUTED SENDS](#query_language-system-stop-distributed-sends), [FLUSH DISTRIBUTED](#query_language-system-flush-distributed) and [START DISTRIBUTED SENDS](#query_language-system-start-distributed-sends). +ClickHouse может оперировать [распределёнными](../operations/table_engines/distributed.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`. ### STOP DISTRIBUTED SENDS {#query_language-system-stop-distributed-sends} -Disables asynchronous distribution of data between servers of the cluster. +Отключает фоновую отправку при вставке данных в распределённые таблицы. ``` SYSTEM STOP DISTRIBUTED SENDS [db.] @@ -18,7 +18,7 @@ SYSTEM STOP DISTRIBUTED SENDS [db.] ### FLUSH DISTRIBUTED {#query_language-system-flush-distributed} -Forces ClickHouse to send data to the servers of the cluster in synchronous mode. If some of the servers are not available, ClickHouse throws an exception and stops query processing. When servers back into operation, you should repeat the query. +В синхронном режиме отправляет все данные на узлы кластера. Если какие-либо узлы недоступны, ClickHouse генерирует исключение и останавливает выполнение запроса. Такой запрос можно повторять до успешного завершения, что будет означать возвращение связанности с остальными узлами кластера. ``` SYSTEM FLUSH DISTRIBUTED [db.] @@ -26,8 +26,11 @@ SYSTEM FLUSH DISTRIBUTED [db.] ### START DISTRIBUTED SENDS {#query_language-system-start-distributed-sends} -Enables asynchronous distribution of data between servers of cluster. +Включает фоновую отправку при вставке данных в распределенные таблицы. ``` SYSTEM START DISTRIBUTED SENDS [db.] ``` + +[Оригинальная статья](https://clickhouse.yandex/docs/ru/query_language/system/) +