DOCAPI-5753: EN review and RU translation for...

DOCAPI-5753: EN review and RU translation for use_minimalistic_part_header_in_zookeeper setting description. (#4956)

docs/en/interfaces/formats.md

@@ -334,7 +334,7 @@ ClickHouse ignores spaces between elements and commas after the objects. You can
 
 ClickHouse substitutes omitted values with the default values for the corresponding [data types](../data_types/index.md).
 
-If `DEFAULT expr` is specified, ClickHouse uses different substitution rules depending on the [insert_sample_with_metadata](../operations/settings/settings.md#session_settings-insert_sample_with_metadata) setting.
+If `DEFAULT expr` is specified, ClickHouse uses different substitution rules depending on the [input_format_defaults_for_omitted_fields](../operations/settings/settings.md#session_settings-input_format_defaults_for_omitted_fields) setting.
 
 Consider the following table:
 

docs/en/operations/server_settings/settings.md

@@ -709,29 +709,29 @@ For more information, see the section "[Replication](../../operations/table_engi
 
 ## use_minimalistic_part_header_in_zookeeper {#server-settings-use_minimalistic_part_header_in_zookeeper}
 
-Storage method of the data parts headers in ZooKeeper.
+Storage method for data part headers in ZooKeeper.
 
-This setting applies only to the `MergeTree`-family and it can be specified:
+This setting only applies to the `MergeTree` family. It can be specified:
 
 - Globally in the [merge_tree](#server_settings-merge_tree) section of the `config.xml` file.
 
-    ClickHouse uses the setting for all the tables on the server. You can change the setting at any time. Existing tables change their behavior with the setting change.
+    ClickHouse uses the setting for all the tables on the server. You can change the setting at any time. Existing tables change their behavior when the setting changes.
 
 - For each individual table.
 
-    When creating a table, specify the corresponding [engine setting](../table_engines/mergetree.md#table_engine-mergetree-creating-a-table). After creating a table you can't change its behavior even with the global setting.
+    When creating a table, specify the corresponding [engine setting](../table_engines/mergetree.md#table_engine-mergetree-creating-a-table). The behavior of an existing table with this setting does not change, even if the global setting changes.
 
 **Possible values**
 
 - 0 — Functionality is turned off.
 - 1 — Functionality is turned on.
 
-If `use_minimalistic_part_header_in_zookeeper = 1`, then [replicated](../table_engines/replication.md) tables store the headers of the data parts compactly using single `znode`. If the table contains many columns, this way of storage significantly reduces the volume of the data stored in Zookeeper.
+If `use_minimalistic_part_header_in_zookeeper = 1`, then [replicated](../table_engines/replication.md) tables store the headers of the data parts compactly using a single `znode`. If the table contains many columns, this storage method significantly reduces the volume of the data stored in Zookeeper.
 
 !!! attention
-    Ones applying the `use_minimalistic_part_header_in_zookeeper = 1` you can't degrade the ClickHouse server to the version that doesn't support this setting. Be careful when upgrading ClickHouse on servers of a cluster. Don't upgrade all the servers at ones. It is safer to test the new versions of ClickHouse in a test environment, or at least at some servers of a cluster.
+    After applying `use_minimalistic_part_header_in_zookeeper = 1`, you can't downgrade the ClickHouse server to a version that doesn't support this setting. Be careful when upgrading ClickHouse on servers in a cluster. Don't upgrade all the servers at once. It is safer to test new versions of ClickHouse in a test environment, or on just a few servers of a cluster.
 
-    The data parts headers already stored with this setting also can't be restored to previous (non-compact) representation.
+    Data part headers already stored with this setting can't be restored to their previous (non-compact) representation.
 
 **Default value:** 0.
 

docs/en/operations/settings/settings.md

@@ -185,11 +185,11 @@ Ok.
 ```
 
 
-## insert_sample_with_metadata {#session_settings-insert_sample_with_metadata}
+## input_format_defaults_for_omitted_fields {#session_settings-input_format_defaults_for_omitted_fields}
 
 Turns on/off the extended data exchange between a ClickHouse client and a ClickHouse server. This setting applies for `INSERT` queries.
 
-When executing the `INSERT` query, the ClickHouse client prepares data and sends it to the server for writing. The client gets the table structure from the server when preparing the data. In some cases, the client needs more information than the server sends by default. Turn on the extended data exchange with `insert_sample_with_metadata = 1`.
+When executing the `INSERT` query, ClickHouse client prepares data and sends it to the server for writing. During the preparation of the data, the client gets the table structure from the server. In some cases, the client needs more information than the server sends by default. Turn on the extended data exchange with `input_format_defaults_for_omitted_fields = 1`.
 
 When the extended data exchange is enabled, the server sends the additional metadata along with the table structure. The composition of the metadata depends on the operation.
 

docs/ru/interfaces/formats.md

@@ -334,7 +334,7 @@ ClickHouse игнорирует пробелы между элементами
 
 ClickHouse заменяет опущенные значения значениями по умолчанию для соответствующих [data types](../data_types/index.md).
 
-Если указано `DEFAULT expr`, то ClickHouse использует различные правила подстановки в зависимости от настройки [insert_sample_with_metadata](../operations/settings/settings.md#session_settings-insert_sample_with_metadata).
+Если указано `DEFAULT expr`, то ClickHouse использует различные правила подстановки в зависимости от настройки [input_format_defaults_for_omitted_fields](../operations/settings/settings.md#session_settings-input_format_defaults_for_omitted_fields).
 
 Рассмотрим следующую таблицу:
 

docs/ru/operations/server_settings/settings.md

-# Серверные настройки
-
+# Конфигурационные параметры сервера
 
 ## builtin_dictionaries_reload_interval
 
@@ -89,8 +88,8 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
 
 Путь:
 
--   Указывается абсолютным или относительно конфигурационного файла сервера.
--   Может содержать wildcard-ы \* и ?.
+- Указывается абсолютным или относительно конфигурационного файла сервера.
+- Может содержать wildcard-ы \* и ?.
 
 Смотрите также "[Внешние словари](../../query_language/dicts/external_dicts.md)".
 
@@ -640,7 +639,7 @@ TCP порт для защищённого обмена данными с кли
 ```
 
 
-## uncompressed_cache_size  {#server-settings-uncompressed_cache_size}
+## uncompressed_cache_size {#server-settings-uncompressed_cache_size}
 
 Размер кеша (в байтах) для несжатых данных, используемых движками таблиц семейства [MergeTree](../../operations/table_engines/mergetree.md).
 
@@ -669,10 +668,10 @@ TCP порт для защищённого обмена данными с кли
 
 Путь к файлу, который содержит:
 
--   Конфигурации пользователей.
--   Права доступа.
--   Профили настроек.
--   Настройки квот.
+- Конфигурации пользователей.
+- Права доступа.
+- Профили настроек.
+- Настройки квот.
 
 **Пример**
 
@@ -710,4 +709,32 @@ ClickHouse использует ZooKeeper для хранения метадан
 </zookeeper>
 ```
 
+## use_minimalistic_part_header_in_zookeeper {#server-settings-use_minimalistic_part_header_in_zookeeper}
+
+Способ хранения заголовков кусков данных в ZooKeeper.
+
+Параметр применяется только к семейству таблиц `MergeTree`. Его можно установить:
+
+- Глобально в разделе [merge_tree](#server_settings-merge_tree) файла `config.xml`.
+
+    ClickHouse использует этот параметр для всех таблиц на сервере. Вы можете изменить настройку в любое время. Существующие таблицы изменяют свое поведение при изменении параметра.
+
+- Для каждой отдельной таблицы.
+
+    При создании таблицы укажите соответствующую [настройку движка](../table_engines/mergetree.md#table_engine-mergetree-creating-a-table). Поведение существующей таблицы с установленным параметром не изменяется даже при изменении глобального параметра.
+
+**Возможные значения**
+
+- 0 — функциональность выключена.
+- 1 — функциональность включена.
+
+Если `use_minimalistic_part_header_in_zookeeper = 1`, то [реплицированные](../table_engines/replication.md) таблицы хранят заголовки кусков данных в компактном виде, используя только одну `znode`. Если таблица содержит много столбцов, этот метод хранения значительно уменьшает объем данных, хранящихся в Zookeeper.
+
+!!! attention "Внимание"
+    После того как вы установили `use_minimalistic_part_header_in_zookeeper = 1`, невозможно откатить ClickHouse до версии, которая не поддерживает этот параметр. Будьте осторожны при обновлении ClickHouse на серверах в кластере. Не обновляйте все серверы сразу. Безопаснее проверять новые версии ClickHouse в тестовой среде или только на некоторых серверах кластера.
+
+    Заголовки частей данных, ранее сохранённые с этим параметром, не могут быть восстановлены в их предыдущем (некомпактном) представлении.
+
+**Значение по умолчанию**: 0.
+
 [Оригинальная статья](https://clickhouse.yandex/docs/ru/operations/server_settings/settings/) <!--hide-->

docs/ru/operations/settings/settings.md

@@ -101,11 +101,11 @@ ClickHouse применяет настройку в тех случаях, ко
 
 В случае превышения `input_format_allow_errors_ratio` ClickHouse генерирует исключение.
 
-## insert_sample_with_metadata {#session_settings-insert_sample_with_metadata}
+## input_format_defaults_for_omitted_fields {#session_settings-input_format_defaults_for_omitted_fields}
 
 Включает/выключает расширенный обмен данными между клиентом ClickHouse и сервером ClickHouse. Параметр применяется для запросов `INSERT`.
 
-При выполнении запроса`INSERT`, клиент ClickHouse подготавливает данные и отправляет их на сервер для записи. При подготовке данных клиент получает структуру таблицы от сервера. В некоторых случаях клиенту требуется больше информации, чем сервер отправляет по умолчанию. Включите расширенный обмен данными с помощью настройки `insert_sample_with_metadata = 1`.
+При выполнении запроса`INSERT`, клиент ClickHouse подготавливает данные и отправляет их на сервер для записи. При подготовке данных клиент получает структуру таблицы от сервера. В некоторых случаях клиенту требуется больше информации, чем сервер отправляет по умолчанию. Включите расширенный обмен данными с помощью настройки `input_format_defaults_for_omitted_fields = 1`.
 
 Если расширенный обмен данными включен, сервер отправляет дополнительные метаданные вместе со структурой таблицы. Состав метаданных зависит от операции.