From fa6856ab5efed7f352dfc9ff9f03123facab5eea Mon Sep 17 00:00:00 2001 From: karnevil13 Date: Wed, 20 Oct 2021 01:38:34 +0300 Subject: [PATCH 1/9] edit&translate --- .../settings.md | 24 +++++++++++++++++++ .../sql-reference/functions/nlp-functions.md | 2 +- .../statements/create/dictionary.md | 8 +++---- 3 files changed, 29 insertions(+), 5 deletions(-) diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md index bab67b62752..cb53e245dd9 100644 --- a/docs/ru/operations/server-configuration-parameters/settings.md +++ b/docs/ru/operations/server-configuration-parameters/settings.md @@ -467,6 +467,30 @@ ClickHouse проверяет условия для `min_part_size` и `min_part 127.0.0.1 ``` +## listen_backlog {#server_configuration_parameters-listen_backlog} + +Бэклог (размер очереди соединений, ожидающих принятия) прослушивающего сокета. + +Значение по умолчанию: `4096` (как в linux [5.4+](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=19f92a030ca6d772ab44b22ee6a01378a8cb32d4)). + +Обычно это значение незачем менять по следующим причинам: +- значение по умолчанию достаточно велико, +- для принятия соединения клиента у сервера есть отдельный поток. + +Так что даже если у вас `TcpExtListenOverflows` (из `nstat`) не на нуле +и это число растет, для сервера ClickHouse это не повод увеличивать значение +по умолчанию, поскольку: +- обычно если 4096 недостаточно, это говорит о внутренних проблемах ClickHouse с масштабированием, + так что лучше сообщить о проблеме, +- и это не значит, что сервер сможет принять еще больше подключений в дальнейшем +(а если и сможет, клиенты, вероятно, отсоединятся). + +Примеры: + +``` xml +4096 +``` + ## logger {#server_configuration_parameters-logger} Настройки логирования. diff --git a/docs/ru/sql-reference/functions/nlp-functions.md b/docs/ru/sql-reference/functions/nlp-functions.md index 58c4eb86e35..250403ab127 100644 --- a/docs/ru/sql-reference/functions/nlp-functions.md +++ b/docs/ru/sql-reference/functions/nlp-functions.md @@ -28,7 +28,7 @@ stem('language', word) Query: ``` sql -SELECT SELECT arrayMap(x -> stem('en', x), ['I', 'think', 'it', 'is', 'a', 'blessing', 'in', 'disguise']) as res; +SELECT arrayMap(x -> stem('en', x), ['I', 'think', 'it', 'is', 'a', 'blessing', 'in', 'disguise']) as res; ``` Result: diff --git a/docs/ru/sql-reference/statements/create/dictionary.md b/docs/ru/sql-reference/statements/create/dictionary.md index a41b2cb9ad5..25546549feb 100644 --- a/docs/ru/sql-reference/statements/create/dictionary.md +++ b/docs/ru/sql-reference/statements/create/dictionary.md @@ -8,10 +8,10 @@ toc_title: "Словарь" ``` sql CREATE DICTIONARY [IF NOT EXISTS] [db.]dictionary_name [ON CLUSTER cluster] ( - key1 type1 [DEFAULT|EXPRESSION expr1] [HIERARCHICAL|INJECTIVE|IS_OBJECT_ID], - key2 type2 [DEFAULT|EXPRESSION expr2] [HIERARCHICAL|INJECTIVE|IS_OBJECT_ID], - attr1 type2 [DEFAULT|EXPRESSION expr3], - attr2 type2 [DEFAULT|EXPRESSION expr4] + key1 type1 [DEFAULT|EXPRESSION expr1] [IS_OBJECT_ID], + key2 type2 [DEFAULT|EXPRESSION expr2], + attr1 type2 [DEFAULT|EXPRESSION expr3] [HIERARCHICAL|INJECTIVE], + attr2 type2 [DEFAULT|EXPRESSION expr4] [HIERARCHICAL|INJECTIVE] ) PRIMARY KEY key1, key2 SOURCE(SOURCE_NAME([param1 value1 ... paramN valueN])) From 910378b64d8169e417c1c0f2f08c3d6737c37f1e Mon Sep 17 00:00:00 2001 From: karnevil13 <90553247+karnevil13@users.noreply.github.com> Date: Thu, 21 Oct 2021 22:45:18 +0300 Subject: [PATCH 2/9] Update docs/ru/operations/server-configuration-parameters/settings.md Co-authored-by: gyuton <40863448+gyuton@users.noreply.github.com> --- docs/ru/operations/server-configuration-parameters/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md index cb53e245dd9..8c0d3f3f90b 100644 --- a/docs/ru/operations/server-configuration-parameters/settings.md +++ b/docs/ru/operations/server-configuration-parameters/settings.md @@ -474,7 +474,7 @@ ClickHouse проверяет условия для `min_part_size` и `min_part Значение по умолчанию: `4096` (как в linux [5.4+](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=19f92a030ca6d772ab44b22ee6a01378a8cb32d4)). Обычно это значение незачем менять по следующим причинам: -- значение по умолчанию достаточно велико, +- значение по умолчанию достаточно велико, - для принятия соединения клиента у сервера есть отдельный поток. Так что даже если у вас `TcpExtListenOverflows` (из `nstat`) не на нуле From 4756c1a3b5d16ca839103b77ed6d44818e176564 Mon Sep 17 00:00:00 2001 From: karnevil13 <90553247+karnevil13@users.noreply.github.com> Date: Thu, 21 Oct 2021 22:45:25 +0300 Subject: [PATCH 3/9] Update docs/ru/operations/server-configuration-parameters/settings.md Co-authored-by: gyuton <40863448+gyuton@users.noreply.github.com> --- docs/ru/operations/server-configuration-parameters/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md index 8c0d3f3f90b..3e0b06c3714 100644 --- a/docs/ru/operations/server-configuration-parameters/settings.md +++ b/docs/ru/operations/server-configuration-parameters/settings.md @@ -475,7 +475,7 @@ ClickHouse проверяет условия для `min_part_size` и `min_part Обычно это значение незачем менять по следующим причинам: - значение по умолчанию достаточно велико, -- для принятия соединения клиента у сервера есть отдельный поток. +- для принятия соединений клиента у сервера есть отдельный поток. Так что даже если у вас `TcpExtListenOverflows` (из `nstat`) не на нуле и это число растет, для сервера ClickHouse это не повод увеличивать значение From 1f00496ffdd7fc56fb1cb2e20ca1dd2aaf14f722 Mon Sep 17 00:00:00 2001 From: karnevil13 <90553247+karnevil13@users.noreply.github.com> Date: Thu, 21 Oct 2021 22:47:33 +0300 Subject: [PATCH 4/9] Update docs/ru/operations/server-configuration-parameters/settings.md Co-authored-by: gyuton <40863448+gyuton@users.noreply.github.com> --- docs/ru/operations/server-configuration-parameters/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md index 3e0b06c3714..c9cd68c515a 100644 --- a/docs/ru/operations/server-configuration-parameters/settings.md +++ b/docs/ru/operations/server-configuration-parameters/settings.md @@ -480,7 +480,7 @@ ClickHouse проверяет условия для `min_part_size` и `min_part Так что даже если у вас `TcpExtListenOverflows` (из `nstat`) не на нуле и это число растет, для сервера ClickHouse это не повод увеличивать значение по умолчанию, поскольку: -- обычно если 4096 недостаточно, это говорит о внутренних проблемах ClickHouse с масштабированием, +- обычно если 4096 недостаточно, это говорит о внутренних проблемах ClickHouse с масштабированием, так что лучше сообщить о проблеме, так что лучше сообщить о проблеме, - и это не значит, что сервер сможет принять еще больше подключений в дальнейшем (а если и сможет, клиенты, вероятно, отсоединятся). From f3d1507b2176be36fb99210c8d51311e6aa8bbd9 Mon Sep 17 00:00:00 2001 From: karnevil13 <90553247+karnevil13@users.noreply.github.com> Date: Thu, 21 Oct 2021 22:47:40 +0300 Subject: [PATCH 5/9] Update docs/ru/operations/server-configuration-parameters/settings.md Co-authored-by: gyuton <40863448+gyuton@users.noreply.github.com> --- docs/ru/operations/server-configuration-parameters/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md index c9cd68c515a..3c6a0d8436e 100644 --- a/docs/ru/operations/server-configuration-parameters/settings.md +++ b/docs/ru/operations/server-configuration-parameters/settings.md @@ -482,7 +482,7 @@ ClickHouse проверяет условия для `min_part_size` и `min_part по умолчанию, поскольку: - обычно если 4096 недостаточно, это говорит о внутренних проблемах ClickHouse с масштабированием, так что лучше сообщить о проблеме, так что лучше сообщить о проблеме, -- и это не значит, что сервер сможет принять еще больше подключений в дальнейшем +- и это не значит, что сервер сможет принять еще больше подключений в дальнейшем (а если и сможет, клиенты, вероятно, уже отсоединятся). (а если и сможет, клиенты, вероятно, отсоединятся). Примеры: From 723e8e2287d3b283c97ee80bfa445ad23c0b0e4e Mon Sep 17 00:00:00 2001 From: karnevil13 <90553247+karnevil13@users.noreply.github.com> Date: Thu, 21 Oct 2021 22:47:47 +0300 Subject: [PATCH 6/9] Update docs/ru/operations/server-configuration-parameters/settings.md Co-authored-by: gyuton <40863448+gyuton@users.noreply.github.com> --- docs/ru/operations/server-configuration-parameters/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md index 3c6a0d8436e..70b92b54bb5 100644 --- a/docs/ru/operations/server-configuration-parameters/settings.md +++ b/docs/ru/operations/server-configuration-parameters/settings.md @@ -477,7 +477,7 @@ ClickHouse проверяет условия для `min_part_size` и `min_part - значение по умолчанию достаточно велико, - для принятия соединений клиента у сервера есть отдельный поток. -Так что даже если у вас `TcpExtListenOverflows` (из `nstat`) не на нуле +Так что даже если у вас `TcpExtListenOverflows` (из `nstat`) ненулевой и растет для сервера ClickHouse, это не повод увеличивать значение по умолчанию, поскольку: и это число растет, для сервера ClickHouse это не повод увеличивать значение по умолчанию, поскольку: - обычно если 4096 недостаточно, это говорит о внутренних проблемах ClickHouse с масштабированием, так что лучше сообщить о проблеме, From d2bcd549f393298453dd8697587e99ea46693369 Mon Sep 17 00:00:00 2001 From: karnevil13 Date: Thu, 21 Oct 2021 23:03:03 +0300 Subject: [PATCH 7/9] line splits fixed --- .../server-configuration-parameters/settings.md | 14 +++++--------- .../server-configuration-parameters/settings.md | 14 +++++--------- 2 files changed, 10 insertions(+), 18 deletions(-) diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md index 425853553ed..975ca139ff0 100644 --- a/docs/en/operations/server-configuration-parameters/settings.md +++ b/docs/en/operations/server-configuration-parameters/settings.md @@ -482,16 +482,12 @@ Backlog (queue size of pending connections) of the listen socket. Default value: `4096` (as in linux [5.4+](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=19f92a030ca6d772ab44b22ee6a01378a8cb32d4)). Usually this value does not need to be changed, since: -- default value is large enough, -- and for accepting client's connections server has separate thread. +- default value is large enough, +- and for accepting client's connections server has separate thread. -So even if you have `TcpExtListenOverflows` (from `nstat`) non zero and this -counter grows for ClickHouse server it does not mean that this value need to be -increased, since: -- usually if 4096 is not enough it shows some internal ClickHouse scaling - issue, so it is better to report an issue. -- and it does not mean that the server can handle more connections later (and - even if it can, clients can already goes away / disconnect). +So even if you have `TcpExtListenOverflows` (from `nstat`) non zero and this counter grows for ClickHouse server it does not mean that this value need to be increased, since: +- usually if 4096 is not enough it shows some internal ClickHouse scaling issue, so it is better to report an issue. +- and it does not mean that the server can handle more connections later (and even if it can, clients can already goes away / disconnect). Examples: diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md index cb53e245dd9..b2e25e715e5 100644 --- a/docs/ru/operations/server-configuration-parameters/settings.md +++ b/docs/ru/operations/server-configuration-parameters/settings.md @@ -474,16 +474,12 @@ ClickHouse проверяет условия для `min_part_size` и `min_part Значение по умолчанию: `4096` (как в linux [5.4+](https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=19f92a030ca6d772ab44b22ee6a01378a8cb32d4)). Обычно это значение незачем менять по следующим причинам: -- значение по умолчанию достаточно велико, -- для принятия соединения клиента у сервера есть отдельный поток. +- значение по умолчанию достаточно велико, +- для принятия соединения клиента у сервера есть отдельный поток. -Так что даже если у вас `TcpExtListenOverflows` (из `nstat`) не на нуле -и это число растет, для сервера ClickHouse это не повод увеличивать значение -по умолчанию, поскольку: -- обычно если 4096 недостаточно, это говорит о внутренних проблемах ClickHouse с масштабированием, - так что лучше сообщить о проблеме, -- и это не значит, что сервер сможет принять еще больше подключений в дальнейшем -(а если и сможет, клиенты, вероятно, отсоединятся). +Так что даже если у вас `TcpExtListenOverflows` (из `nstat`) ненулевой и растет для сервера ClickHouse, это не повод увеличивать значение по умолчанию, поскольку: +- обычно если 4096 недостаточно, это говорит о внутренних проблемах ClickHouse с масштабированием, так что лучше сообщить о проблеме, +- и это не значит, что сервер сможет принять еще больше подключений в дальнейшем (а если и сможет, клиенты, вероятно, уже отсоединятся). Примеры: From 8e2b9eb86017d9eda6fbd1b91d53aa765fb8c3e3 Mon Sep 17 00:00:00 2001 From: karnevil13 <90553247+karnevil13@users.noreply.github.com> Date: Fri, 22 Oct 2021 09:59:41 +0300 Subject: [PATCH 8/9] Update docs/en/operations/server-configuration-parameters/settings.md Co-authored-by: gyuton <40863448+gyuton@users.noreply.github.com> --- docs/en/operations/server-configuration-parameters/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md index 975ca139ff0..aa12c0bea1e 100644 --- a/docs/en/operations/server-configuration-parameters/settings.md +++ b/docs/en/operations/server-configuration-parameters/settings.md @@ -487,7 +487,7 @@ Usually this value does not need to be changed, since: So even if you have `TcpExtListenOverflows` (from `nstat`) non zero and this counter grows for ClickHouse server it does not mean that this value need to be increased, since: - usually if 4096 is not enough it shows some internal ClickHouse scaling issue, so it is better to report an issue. -- and it does not mean that the server can handle more connections later (and even if it can, clients can already goes away / disconnect). +- and it does not mean that the server can handle more connections later (and even if it can, clients can already go away / disconnect). Examples: From 0a2437fe954ab37e2288b8a57a02f6d0dd5777c5 Mon Sep 17 00:00:00 2001 From: karnevil13 Date: Fri, 22 Oct 2021 10:10:25 +0300 Subject: [PATCH 9/9] Update settings.md --- docs/en/operations/server-configuration-parameters/settings.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md index aa12c0bea1e..6590b8f5931 100644 --- a/docs/en/operations/server-configuration-parameters/settings.md +++ b/docs/en/operations/server-configuration-parameters/settings.md @@ -487,7 +487,7 @@ Usually this value does not need to be changed, since: So even if you have `TcpExtListenOverflows` (from `nstat`) non zero and this counter grows for ClickHouse server it does not mean that this value need to be increased, since: - usually if 4096 is not enough it shows some internal ClickHouse scaling issue, so it is better to report an issue. -- and it does not mean that the server can handle more connections later (and even if it can, clients can already go away / disconnect). +- and it does not mean that the server can handle more connections later (and even if it could, by that moment clients may be gone or disconnected). Examples: