Merge pull request #12582 from BayoNet/docs/CLICKHOUSEDOCS-680-max-server-memory-usage-to-ram

DOCS-680: max_server_memory_usage_to_ram

docs/en/operations/server-configuration-parameters/settings.md

@@ -397,7 +397,6 @@ The cache is shared for the server and memory is allocated as needed. The cache
 ``` xml
 <mark_cache_size>5368709120</mark_cache_size>
 ```
-
 ## max\_server\_memory\_usage {#max_server_memory_usage}
 
 Limits total RAM usage by the ClickHouse server. You can specify it only for the default profile.
@@ -411,11 +410,37 @@ Default value: `0`.
 
 **Additional Info**
 
-On hosts with low RAM and swap, you possibly need setting `max_server_memory_usage_to_ram_ratio > 1`.
+The default `max_server_memory_usage` value is calculated as `memory_amount * max_server_memory_usage_to_ram_ratio`.
 
 **See also**
 
 -   [max\_memory\_usage](../../operations/settings/query-complexity.md#settings_max_memory_usage)
+-   [max_server_memory_usage_to_ram_ratio](#max_server_memory_usage_to_ram_ratio)
+
+## max_server_memory_usage_to_ram_ratio {#max_server_memory_usage_to_ram_ratio}
+
+Defines the fraction of total physical RAM amount, available to the Clickhouse server. If the server tries to utilize more, the memory is cut down to the appropriate amount. 
+
+Possible values:
+
+-   Positive double.
+-   0 — The Clickhouse server can use all available RAM.
+
+Default value: `0`.
+
+**Usage**
+
+On hosts with low RAM and swap, you possibly need setting `max_server_memory_usage_to_ram_ratio` larger than 1.
+
+**Example**
+
+``` xml
+<max_server_memory_usage_to_ram_ratio>0.9</max_server_memory_usage_to_ram_ratio>
+```
+
+**See Also**
+
+-   [max_server_memory_usage](#max_server_memory_usage)
 
 ## max\_concurrent\_queries {#max-concurrent-queries}
 

docs/ru/operations/server-configuration-parameters/settings.md

@@ -385,12 +385,37 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
 
 **Дополнительная информация**
 
-На серверах с небольшим объёмом RAM и файла подкачки может потребоваться настройка `max_server_memory_usage_to_ram_ratio > 1`.
+Значение по умолчанию для `max_server_memory_usage` рассчитывается как `memory_amount * max_server_memory_usage_to_ram_ratio`.
 
 **См. также**
 
 -   [max_memory_usage](../settings/query-complexity.md#settings_max_memory_usage)
 
+## max_server_memory_usage_to_ram_ratio {#max_server_memory_usage_to_ram_ratio}
+
+Определяет долю оперативной памяти, доступную для использования сервером Clickhouse. Если сервер попытается использовать больше, предоставляемый ему объём памяти будет ограничен до расчётного значения. 
+
+Возможные значения:
+
+-   Положительное число с плавающей запятой.
+-   0 — сервер Clickhouse может использовать всю оперативную память.
+
+Значение по умолчанию: `0`.
+
+**Использование**
+
+На серверах с небольшим объёмом оперативной памяти и файла подкачки может потребоваться установить настройку `max_server_memory_usage_to_ram_ratio` в значение, большее 1.
+
+**Пример**
+
+``` xml
+<max_server_memory_usage_to_ram_ratio>0.9</max_server_memory_usage_to_ram_ratio>
+```
+
+**См. также**
+
+-   [max_server_memory_usage](#max_server_memory_usage)
+
 ## max\_connections {#max-connections}
 
 Максимальное количество входящих соединений.