DOCS-609: max_server_memory_usage (#11771)

* Revolg DOCSUP-1000 add max server memory usage setting (#125)

* Add max_server_memory_usage setting, delete max_memory_usage_for_all_queries setting.

* Syntax fixed

* Apply suggestions from code review
Co-authored-by: NBayoNet <da-daos@yandex.ru>

* Doc for the max_server_memory_usage setting. Updates.
Co-authored-by: NOlga Revyakina <revolg@yandex-team.ru>
Co-authored-by: NBayoNet <da-daos@yandex.ru>

* CLICKHOUSEDOCS-609: Minor fixes.

* CLICKHOUSEDOCS-609: Actualized position of the setting.
Co-authored-by: Nolgarev <56617294+olgarev@users.noreply.github.com>
Co-authored-by: NOlga Revyakina <revolg@yandex-team.ru>
Co-authored-by: NSergei Shtykov <bayonet@yandex-team.ru>

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

@@ -398,6 +398,27 @@ The cache is shared for the server and memory is allocated as needed. The cache
 <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.
+
+Possible values:
+
+-   Positive integer.
+-   0 — Unlimited.
+
+Default value: `0`.
+
+**Additional Info**
+
+On hosts with low RAM and swap, you possibly need setting `max_server_memory_usage_to_ram_ratio > 1`.
+
+**See also**
+
+-   [max_memory_usage](../settings/query-complexity.md#settings_max_memory_usage)
+
+
 ## max\_concurrent\_queries {#max-concurrent-queries}
 
 The maximum number of simultaneously processed requests.

docs/en/operations/settings/query-complexity.md

@@ -36,7 +36,7 @@ Memory usage is not monitored for the states of certain aggregate functions.
 
 Memory usage is not fully tracked for states of the aggregate functions `min`, `max`, `any`, `anyLast`, `argMin`, `argMax` from `String` and `Array` arguments.
 
-Memory consumption is also restricted by the parameters `max_memory_usage_for_user` and `max_memory_usage_for_all_queries`.
+Memory consumption is also restricted by the parameters `max_memory_usage_for_user` and [max_server_memory_usage](../server-configuration-parameters/settings.md#max_server_memory_usage).
 
 ## max\_memory\_usage\_for\_user {#max-memory-usage-for-user}
 
@@ -46,13 +46,6 @@ Default values are defined in [Settings.h](https://github.com/ClickHouse/ClickHo
 
 See also the description of [max\_memory\_usage](#settings_max_memory_usage).
 
-## max\_memory\_usage\_for\_all\_queries {#max-memory-usage-for-all-queries}
-
-The maximum amount of RAM to use for running all queries on a single server.
-
-Default values are defined in [Settings.h](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.h#L289). By default, the amount is not restricted (`max_memory_usage_for_all_queries = 0`).
-
-See also the description of [max\_memory\_usage](#settings_max_memory_usage).
 
 ## max\_rows\_to\_read {#max-rows-to-read}
 

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

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

docs/ru/operations/settings/query-complexity.md

-# Ограничения на сложность запроса {#ogranicheniia-na-slozhnost-zaprosa}
+# Ограничения на сложность запроса {#restrictions-on-query-complexity}
 
 Ограничения на сложность запроса - часть настроек.
 Используются, чтобы обеспечить более безопасное исполнение запросов из пользовательского интерфейса.
@@ -32,7 +32,7 @@
 
 Потребление памяти не полностью учитывается для состояний агрегатных функций `min`, `max`, `any`, `anyLast`, `argMin`, `argMax` от аргументов `String` и `Array`.
 
-Потребление памяти ограничивается также параметрами `max_memory_usage_for_user` и `max_memory_usage_for_all_queries`.
+Потребление памяти ограничивается также параметрами `max_memory_usage_for_user` и [max_server_memory_usage](../server-configuration-parameters/settings.md#max_server_memory_usage).
 
 ## max\_memory\_usage\_for\_user {#max-memory-usage-for-user}
 
@@ -42,14 +42,6 @@
 
 Смотрите также описание настройки [max\_memory\_usage](#settings_max_memory_usage).
 
-## max\_memory\_usage\_for\_all\_queries {#max-memory-usage-for-all-queries}
-
-Максимальный возможный объём оперативной памяти для всех запросов на одном сервере.
-
-Значения по умолчанию определены в файле [Settings.h](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.h#L289). По умолчанию размер не ограничен (`max_memory_usage_for_all_queries = 0`).
-
-Смотрите также описание настройки [max\_memory\_usage](#settings_max_memory_usage).
-
 ## max\_rows\_to\_read {#max-rows-to-read}
 
 Следующие ограничения могут проверяться на каждый блок (а не на каждую строку). То есть, ограничения могут быть немного нарушены.