ClickHouse · BayoNet · Nov 5, 2019 · Aug 16, 2019 · Aug 16, 2019 · Aug 19, 2019
diff --git a/docs/en/operations/settings/settings.md b/docs/en/operations/settings/settings.md
@@ -839,25 +839,32 @@ Default value: `uniqExact`.
 
 ## skip_unavailable_shards {#settings-skip_unavailable_shards}
 
-Enables or disables silent skipping of:
+Enables or disables silently skipping of unavailable shards.
 
-- Node, if its name cannot be resolved through DNS.
+Shard is considered unavailable if all its replicas are unavailable. A replica is unavailable in the following cases:
 
-    When skipping is disabled, ClickHouse requires that all the nodes in the [cluster configuration](../server_settings/settings.md#server_settings_remote_servers) can be resolvable through DNS. Otherwise, ClickHouse throws an exception when trying to perform a query on the cluster.
+- ClickHouse can't connect to replica for any reason.
 
-    If skipping is enabled, ClickHouse considers unresolved nodes as unavailable and tries to resolve them at every connection attempt. Such behavior creates the risk of wrong cluster configuration because a user can specify the wrong node name, and ClickHouse doesn't report about it. However, this can be useful in systems with dynamic DNS, for example, [Kubernetes](https://kubernetes.io), where nodes can be unresolvable during downtime, and this is not an error.
+    When connecting to a replica, ClickHouse performs several attempts. If all these attempts fail, the replica is considered unavailable.
 
-- Shard, if there are no available replicas of the shard.
+- Replica can't be resolved through DNS.
 
-    When skipping is disabled, ClickHouse throws an exception.
+    If replica's hostname can't be resolved through DNS, it can indicate the following situations:
 
-    When skipping is enabled, ClickHouse returns a partial answer and doesn't report about issues with nodes availability.
+    - Replica's host has no DNS record. It can occur in systems with dynamic DNS, for example, [Kubernetes](https://kubernetes.io), where nodes can be unresolvable during downtime, and this is not an error.
+
+    - Configuration error. ClickHouse configuration file contains a wrong hostname.
 
 Possible values:
 
 - 1 — skipping enabled.
+
+    If a shard is unavailable, ClickHouse returns a result based on partial data and doesn't report node availability issues. 
+
 - 0 — skipping disabled.
 
+    If a shard is unavailable, ClickHouse throws an exception.
+
 Default value: 0.
 
 ## optimize_throw_if_noop {#setting-optimize_throw_if_noop}

diff --git a/docs/en/operations/table_engines/buffer.md b/docs/en/operations/table_engines/buffer.md
@@ -10,7 +10,7 @@ Engine parameters:
 
 - `database` – Database name. Instead of the database name, you can use a constant expression that returns a string.
 - `table` – Table to flush data to. 
-- `num_layers` – Parallelism layer. Physically, the table will be represented as 'num_layers' of independent buffers. Recommended value: 16.
+- `num_layers` – Parallelism layer. Physically, the table will be represented as `num_layers` of independent buffers. Recommended value: 16.
 - `min_time`, `max_time`, `min_rows`, `max_rows`, `min_bytes`, and `max_bytes` – Conditions for flushing data from the buffer.
 
 Data is flushed from the buffer and written to the destination table if all the `min*` conditions or at least one `max*` condition are met.

diff --git a/docs/en/operations/table_engines/mergetree.md b/docs/en/operations/table_engines/mergetree.md
@@ -172,7 +172,7 @@ The number of columns in the primary key is not explicitly limited. Depending on
 - Improve the performance of an index.
 
     If the primary key is `(a, b)`, then adding another column `c` will improve the performance if the following conditions are met:
-    
+
     - There are queries with a condition on column `c`.
     - Long data ranges (several times longer than the `index_granularity`) with identical values for `(a, b)` are common. In other words, when adding another column allows you to skip quite long data ranges.
 

diff --git a/docs/ru/operations/server_settings/settings.md b/docs/ru/operations/server_settings/settings.md
@@ -577,11 +577,9 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
 ```
 
 
-## remote_servers
+## remote_servers {#server_settings_remote_servers}
 
-Конфигурация кластеров, которые использует движок таблиц Distributed.
-
-Пример настройки смотрите в разделе "[Движки таблиц/Distributed](../../operations/table_engines/distributed.md)".
+Конфигурация кластеров, которые использует движок таблиц [Distributed](../../operations/table_engines/distributed.md) и табличная функция `cluster`.
 
 **Пример**
 
@@ -592,6 +590,9 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
 Значение атрибута `incl` смотрите в разделе "[Конфигурационные файлы](../configuration_files.md#configuration_files)".
 
 
+**Смотрите также**
+
+ - [skip_unavailable_shards](../settings/settings.md#settings-skip_unavailable_shards)
 
 ## timezone
 

diff --git a/docs/ru/operations/settings/settings.md b/docs/ru/operations/settings/settings.md
@@ -845,6 +845,36 @@ load_balancing = first_or_random
 - [Множественный JOIN](../../query_language/select.md#select-join)
 
 
+## skip_unavailable_shards {#settings-skip_unavailable_shards}
+
+Включает или отключает тихий пропуск недоступных шардов.
+
+Шард считается недоступным, если все его реплики недоступны. Реплика недоступна в следующих случаях:
+
+- ClickHouse не может установить соединение с репликой по любой причине.
+
+    ClickHouse предпринимает несколько попыток подключиться к реплике. Если все попытки оказались неудачными, реплика считается недоступной.
+
+- Реплика не может быть разрешена с помощью DNS.
+
+    Если имя хоста реплики не может быть разрешено с помощью DNS, это может указывать на следующие ситуации:
+
+    - Нет записи DNS для хоста. Это может происходить в системах с динамическим DNS, например, [Kubernetes](https://kubernetes.io), где отключенные ноды не разрешаться с помощью DNS и это не ошибка.
+
+    - Ошибка конфигурации. Конфигурационный файл ClickHouse может содержать неправильное имя хоста.
+
+Возможные значения:
+
+- 1 — пропуск включен.
+
+    Если шард недоступен, то ClickHouse возвращает результат, основанный на неполных данных и не оповещает о проблемах с доступностью хостов.
+
+- 0 — пропуск выключен.
+
+    Если шард недоступен, то ClickHouse генерирует исключение.
+
+Значение по умолчанию — 0.
+
 ## optimize_throw_if_noop {#setting-optimize_throw_if_noop}
 
 Включает или отключает генерирование исключения в в случаях, когда запрос [OPTIMIZE](../../query_language/misc.md#misc_operations-optimize) не выполняет мёрж.
@@ -858,6 +888,7 @@ load_balancing = first_or_random
 
 Значение по умолчанию — 0.
 
+
 ## os_thread_priority {#setting-os_thread_priority}
 
 Устанавливает приоритет ([nice](https://en.wikipedia.org/wiki/Nice_(Unix))) для потоков, исполняющих запросы. Планировщик ОС учитывает эти приоритеты при выборе следующего потока для исполнения на доступном ядре CPU.

diff --git a/docs/ru/operations/table_engines/buffer.md b/docs/ru/operations/table_engines/buffer.md
@@ -7,18 +7,21 @@ Buffer(database, table, num_layers, min_time, max_time, min_rows, max_rows, min_
 ```
 
 Параметры движка:
-database, table - таблица, в которую сбрасывать данные. Вместо имени базы данных может использоваться константное выражение, возвращающее строку.
-num_layers - уровень параллелизма. Физически таблица будет представлена в виде num_layers независимых буферов. Рекомендуемое значение - 16.
-min_time, max_time, min_rows, max_rows, min_bytes, max_bytes - условия для сброса данных из буфера.
 
-Данные сбрасываются из буфера и записываются в таблицу назначения, если выполнены все min-условия или хотя бы одно max-условие.
-min_time, max_time - условие на время в секундах от момента первой записи в буфер;
-min_rows, max_rows - условие на количество строк в буфере;
-min_bytes, max_bytes - условие на количество байт в буфере.
+`database` — имя базы данных.  Вместо имени базы данных может использоваться константное выражение, возвращающее строку.
+`table` — таблица, в которую сбрасывать данные.
+`num_layers` — уровень параллелизма. Физически таблица будет представлена в виде `num_layers` независимых буферов. Рекомендуемое значение — 16.
+`min_time`, `max_time`, `min_rows`, `max_rows`, `min_bytes`, `max_bytes` — условия для сброса данных из буфера.
 
-При записи, данные вставляются в случайный из num_layers буферов. Или, если размер куска вставляемых данных достаточно большой (больше max_rows или max_bytes), то он записывается в таблицу назначения минуя буфер.
+Данные сбрасываются из буфера и записываются в таблицу назначения, если выполнены все `min`-условия или хотя бы одно `max`-условие.
 
-Условия для сброса данных учитываются отдельно для каждого из num_layers буферов. Например, если num_layers = 16 и max_bytes = 100000000, то максимальный расход оперативки будет 1.6 GB.
+- `min_time`, `max_time` — условие на время в секундах от момента первой записи в буфер.
+- `min_rows`, `max_rows` — условие на количество строк в буфере.
+- `min_bytes`, `max_bytes` — условие на количество байт в буфере.
+
+При записи, данные вставляются в случайный из `num_layers` буферов. Или, если размер куска вставляемых данных достаточно большой (больше `max_rows` или `max_bytes`), то он записывается в таблицу назначения минуя буфер.
+
+Условия для сброса данных учитываются отдельно для каждого из `num_layers` буферов. Например, если `num_layers = 16` и `max_bytes = 100000000`, то максимальный расход оперативки будет 1.6 GB.
 
 Пример: