diff --git a/docs/en/operations/server-configuration-parameters/settings.md b/docs/en/operations/server-configuration-parameters/settings.md
index 80d4d659bd3..c1ac1d0d92d 100644
--- a/docs/en/operations/server-configuration-parameters/settings.md
+++ b/docs/en/operations/server-configuration-parameters/settings.md
@@ -339,13 +339,13 @@ Writing to the syslog is also supported. Config example:
```
-Keys:
+Keys for syslog:
- use\_syslog — Required setting if you want to write to the syslog.
- address — The host\[:port\] of syslogd. If omitted, the local daemon is used.
- hostname — Optional. The name of the host that logs are sent from.
- facility — [The syslog facility keyword](https://en.wikipedia.org/wiki/Syslog#Facility) in uppercase letters with the “LOG\_” prefix: (`LOG_USER`, `LOG_DAEMON`, `LOG_LOCAL3`, and so on).
- Default value: `LOG_USER` if `address` is specified, `LOG_DAEMON otherwise.`
+ Default value: `LOG_USER` if `address` is specified, `LOG_DAEMON` otherwise.
- format – Message format. Possible values: `bsd` and `syslog.`
## send\_crash\_reports {#server_configuration_parameters-logger}
@@ -357,8 +357,8 @@ The server will need an access to public Internet via IPv4 (at the time of writi
Keys:
-- `enabled` – Boolean flag to enable the feature. Set to `true` to allow sending crash reports.
-- `endpoint` – Overrides the Sentry endpoint.
+- `enabled` – Boolean flag to enable the feature, `false` by default. Set to `true` to allow sending crash reports.
+- `endpoint` – You can override the Sentry endpoint URL for sending crash reports. It can be either separate Sentry account or your self-hosted Sentry instance. Use the [Sentry DSN](https://docs.sentry.io/error-reporting/quickstart/?platform=native#configure-the-sdk) syntax.
- `anonymize` - Avoid attaching the server hostname to crash report.
- `http_proxy` - Configure HTTP proxy for sending crash reports.
- `debug` - Sets the Sentry client into debug mode.
@@ -397,6 +397,7 @@ The cache is shared for the server and memory is allocated as needed. The cache
``` xml
5368709120
```
+
## max\_server\_memory\_usage {#max_server_memory_usage}
Limits total RAM usage by the ClickHouse server.
@@ -589,7 +590,8 @@ Use the following parameters to configure logging:
- `database` – Name of the database.
- `table` – Name of the system table.
-- `partition_by` – Sets a [custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md).
+- `partition_by` — [Custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a system table. Can't be used if `engine` defined.
+- `engine` - [MergeTree Engine Definition](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) for a system table. Can't be used if `partition_by` defined.
- `flush_interval_milliseconds` – Interval for flushing data from the buffer in memory to the table.
**Example**
@@ -650,7 +652,8 @@ Use the following parameters to configure logging:
- `database` – Name of the database.
- `table` – Name of the system table the queries will be logged in.
-- `partition_by` – Sets a [custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a table.
+- `partition_by` — [Custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a system table. Can't be used if `engine` defined.
+- `engine` - [MergeTree Engine Definition](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) for a system table. Can't be used if `partition_by` defined.
- `flush_interval_milliseconds` – Interval for flushing data from the buffer in memory to the table.
If the table doesn’t exist, ClickHouse will create it. If the structure of the query log changed when the ClickHouse server was updated, the table with the old structure is renamed, and a new table is created automatically.
@@ -661,7 +664,7 @@ If the table doesn’t exist, ClickHouse will create it. If the structure of the
system
- toMonday(event_date)
+ Engine = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_date + INTERVAL 30 day
7500
```
@@ -676,7 +679,8 @@ Use the following parameters to configure logging:
- `database` – Name of the database.
- `table` – Name of the system table the queries will be logged in.
-- `partition_by` – Sets a [custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a system table.
+- `partition_by` — [Custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a system table. Can't be used if `engine` defined.
+- `engine` - [MergeTree Engine Definition](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) for a system table. Can't be used if `partition_by` defined.
- `flush_interval_milliseconds` – Interval for flushing data from the buffer in memory to the table.
If the table doesn’t exist, ClickHouse will create it. If the structure of the query thread log changed when the ClickHouse server was updated, the table with the old structure is renamed, and a new table is created automatically.
@@ -692,6 +696,34 @@ If the table doesn’t exist, ClickHouse will create it. If the structure of the
```
+## text\_log {#server_configuration_parameters-text_log}
+
+Settings for the [text\_log](../../operations/system-tables/text_log.md#system_tables-text_log) system table for logging text messages.
+
+Parameters:
+
+- `level` — Maximum Message Level (by default `Trace`) which will be stored in a table.
+- `database` — Database name.
+- `table` — Table name.
+- `partition_by` — [Custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a system table. Can't be used if `engine` defined.
+- `engine` - [MergeTree Engine Definition](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) for a system table. Can't be used if `partition_by` defined.
+- `flush_interval_milliseconds` — Interval for flushing data from the buffer in memory to the table.
+
+**Example**
+```xml
+
+
+ notice
+ system
+
+ 7500
+
+ Engine = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_date + INTERVAL 30 day
+
+
+```
+
+
## trace\_log {#server_configuration_parameters-trace_log}
Settings for the [trace\_log](../../operations/system-tables/trace_log.md#system_tables-trace_log) system table operation.
@@ -700,7 +732,8 @@ Parameters:
- `database` — Database for storing a table.
- `table` — Table name.
-- `partition_by` — [Custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a system table.
+- `partition_by` — [Custom partitioning key](../../engines/table-engines/mergetree-family/custom-partitioning-key.md) for a system table. Can't be used if `engine` defined.
+- `engine` - [MergeTree Engine Definition](../../engines/table-engines/mergetree-family/index.md) for a system table. Can't be used if `partition_by` defined.
- `flush_interval_milliseconds` — Interval for flushing data from the buffer in memory to the table.
The default server configuration file `config.xml` contains the following settings section:
@@ -717,7 +750,7 @@ The default server configuration file `config.xml` contains the following settin
## query\_masking\_rules {#query-masking-rules}
Regexp-based rules, which will be applied to queries as well as all log messages before storing them in server logs,
-`system.query_log`, `system.text_log`, `system.processes` table, and in logs sent to the client. That allows preventing
+`system.query_log`, `system.text_log`, `system.processes` tables, and in logs sent to the client. That allows preventing
sensitive data leakage from SQL queries (like names, emails, personal
identifiers or credit card numbers) to logs.
diff --git a/docs/en/operations/system-tables/text_log.md b/docs/en/operations/system-tables/text_log.md
index f4ba37e9568..bd92519b96b 100644
--- a/docs/en/operations/system-tables/text_log.md
+++ b/docs/en/operations/system-tables/text_log.md
@@ -1,4 +1,4 @@
-# system.text_log {#system-tables-text-log}
+# system.text\_log {#system_tables-text_log}
Contains logging entries. Logging level which goes to this table can be limited with `text_log.level` server setting.
diff --git a/docs/es/operations/system-tables.md b/docs/es/operations/system-tables.md
index aca9c0cc917..6f487ce66e3 100644
--- a/docs/es/operations/system-tables.md
+++ b/docs/es/operations/system-tables.md
@@ -532,7 +532,7 @@ Columna:
- `query` (String) – The query text. For `INSERT`, no incluye los datos para insertar.
- `query_id` (String) – Query ID, if defined.
-## sistema.text\_log {#system-tables-text-log}
+## sistema.text\_log {#system_tables-text_log}
Contiene entradas de registro. El nivel de registro que va a esta tabla se puede limitar con `text_log.level` configuración del servidor.
diff --git a/docs/fa/operations/system-tables.md b/docs/fa/operations/system-tables.md
index f601dbc5804..39e90e4130f 100644
--- a/docs/fa/operations/system-tables.md
+++ b/docs/fa/operations/system-tables.md
@@ -532,7 +532,7 @@ CurrentMetric_ReplicatedChecks: 0
- `query` (String) – The query text. For `INSERT` این شامل داده ها برای وارد کردن نیست.
- `query_id` (String) – Query ID, if defined.
-## سیستم.\_خروج {#system-tables-text-log}
+## سیستم.\_خروج {#system_tables-text_log}
شامل ورودی ورود به سیستم. سطح ورود به سیستم که می رود به این جدول را می توان با محدود `text_log.level` تنظیم سرور.
diff --git a/docs/fr/operations/system-tables.md b/docs/fr/operations/system-tables.md
index 85451607b86..d779f20a96a 100644
--- a/docs/fr/operations/system-tables.md
+++ b/docs/fr/operations/system-tables.md
@@ -532,7 +532,7 @@ Colonne:
- `query` (String) – The query text. For `INSERT` il n'inclut pas les données à insérer.
- `query_id` (String) – Query ID, if defined.
-## système.text\_log {#system-tables-text-log}
+## système.text\_log {#system_tables-text_log}
Contient des entrées de journalisation. Niveau de journalisation qui va à cette table peut être limité `text_log.level` paramètre de serveur.
diff --git a/docs/fr/sql-reference/dictionaries/external-dictionaries/external-dicts-dict-layout.md b/docs/fr/sql-reference/dictionaries/external-dictionaries/external-dicts-dict-layout.md
index 559d8adaa6f..f1e65631a56 100644
--- a/docs/fr/sql-reference/dictionaries/external-dictionaries/external-dicts-dict-layout.md
+++ b/docs/fr/sql-reference/dictionaries/external-dictionaries/external-dicts-dict-layout.md
@@ -320,10 +320,9 @@ ou
LAYOUT(DIRECT())
```
-### complex\_key\_cache {#complex-key-cache}
-
-Ce type de stockage est pour une utilisation avec composite [touches](external-dicts-dict-structure.md). Semblable à `direct`.
+### complex\_key\_direct {#complex-key-direct}
+Ce type de stockage est destiné à être utilisé avec des [clés](../../../sql-reference/dictionaries/external-dictionaries/external-dicts-dict-structure.md) composites. Similaire à `direct`
### ip\_trie {#ip-trie}
diff --git a/docs/ja/operations/system-tables.md b/docs/ja/operations/system-tables.md
index 117076b897d..e7488b0fa44 100644
--- a/docs/ja/operations/system-tables.md
+++ b/docs/ja/operations/system-tables.md
@@ -532,7 +532,7 @@ CurrentMetric_ReplicatedChecks: 0
- `query` (String) – The query text. For `INSERT`,挿入するデータは含まれません。
- `query_id` (String) – Query ID, if defined.
-## システムtext\_log {#system-tables-text-log}
+## システムtext\_log {#system_tables-text_log}
を含むログイン作品の応募がありました。 ログレベルがこのテーブルで限定 `text_log.level` サーバー設定。
diff --git a/docs/ru/operations/server-configuration-parameters/settings.md b/docs/ru/operations/server-configuration-parameters/settings.md
index 63319ed2c01..795a9f5893a 100644
--- a/docs/ru/operations/server-configuration-parameters/settings.md
+++ b/docs/ru/operations/server-configuration-parameters/settings.md
@@ -26,21 +26,28 @@ ClickHouse перезагружает встроенные словари с з
``` xml
-
+ ...
+ ...
+ ...
...
```
-Можно сконфигурировать несколько разделов ``.
-
Поля блока ``:
- `min_part_size` - Минимальный размер части таблицы.
- `min_part_size_ratio` - Отношение размера минимальной части таблицы к полному размеру таблицы.
-- `method` - Метод сжатия. Возможные значения: `lz4`, `zstd` (экспериментальный).
+- `method` - Метод сжатия. Возможные значения: `lz4`, `zstd`.
-ClickHouse проверит условия `min_part_size` и `min_part_size_ratio` и выполнит те блоки `case`, для которых условия совпали. Если ни один `` не подходит, то ClickHouse применит алгоритм сжатия `lz4`.
+Можно сконфигурировать несколько разделов ``.
+
+ClickHouse проверяет условия для `min_part_size` и `min_part_size_ratio` и выполнит те блоки `case`, для которых условия совпали.
+
+- Если кусок данных совпадает с условиями, ClickHouse использует указанные метод сжатия.
+- Если кусок данных совпадает с несколькими блоками `case`, ClickHouse использует перый совпавший блок условий.
+
+Если ни один `` не подходит, то ClickHouse применит алгоритм сжатия `lz4`.
**Пример**
@@ -217,7 +224,7 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
Путь к файлу с подстановками.
-Подробности смотрите в разделе «[Конфигурационный файлы](../configuration-files.md#configuration_files)».
+Подробности смотрите в разделе «[Конфигурационные файлы](../configuration-files.md#configuration_files)».
**Пример**
@@ -295,11 +302,11 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
Ключи:
-- level - Уровень логирования. Допустимые значения: `trace`, `debug`, `information`, `warning`, `error`.
-- log - Файл лога. Содержит все записи согласно `level`.
-- errorlog - Файл лога ошибок.
-- size - Размер файла. Действует для `log` и `errorlog`. Как только файл достиг размера `size`, ClickHouse архивирует и переименовывает его, а на его месте создает новый файл лога.
-- count - Количество заархивированных файлов логов, которые сохраняет ClickHouse.
+- `level` - Уровень логирования. Допустимые значения: `trace`, `debug`, `information`, `warning`, `error`.
+- `log` - Файл лога. Содержит все записи согласно `level`.
+- `errorlog` - Файл лога ошибок.
+- `size` - Размер файла. Действует для `log` и `errorlog`. Как только файл достиг размера `size`, ClickHouse архивирует и переименовывает его, а на его месте создает новый файл лога.
+- `count` - Количество заархивированных файлов логов, которые сохраняет ClickHouse.
**Пример**
@@ -327,14 +334,38 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
```
+Ключи для syslog:
+
+- use\_syslog - обязательная настройка, если требуется запись в syslog
+- address - хост\[:порт\] демона syslogd. Если не указан, используется локальный
+- hostname - опционально, имя хоста, с которого отсылаются логи
+- facility - [категория syslog](https://en.wikipedia.org/wiki/Syslog#Facility), записанная в верхнем регистре, с префиксом «LOG\_»: (`LOG_USER`, `LOG_DAEMON`, `LOG_LOCAL3` и прочие).
+ Значения по умолчанию: при указанном `address` - `LOG_USER`, иначе - `LOG_DAEMON`
+- format - формат сообщений. Возможные значения - `bsd` и `syslog`
+
+## send\_crash\_reports {#server_configuration_parameters-logger}
+
+Настройки для отправки сообщений о сбоях в команду разработчиков ядра ClickHouse через [Sentry](https://sentry.io).
+Включение этих настроек, особенно в pre-production среде, может дать очень ценную информацию и поможет развитию ClickHouse.
+
+Сервер на котором включены данные настройки должен иметь доступ в Интернет по протоколу IPv4 (на момент написания документации IPv6 не поддерживается публичным облаком Sentry) для правильной работы данной функциональности.
+
Ключи:
-- use\_syslog - обязательная настройка, если требуется запись в syslog
-- address - хост\[:порт\] демона syslogd. Если не указан, используется локальный
-- hostname - опционально, имя хоста, с которого отсылаются логи
-- facility - [категория syslog](https://en.wikipedia.org/wiki/Syslog#Facility),
-записанная в верхнем регистре, с префиксом «LOG\_»: (`LOG_USER`, `LOG_DAEMON`, `LOG_LOCAL3` и прочие).
-Значения по умолчанию: при указанном `address` - `LOG_USER`, иначе - `LOG_DAEMON`
-- format - формат сообщений. Возможные значения - `bsd` и `syslog`
+
+- `enabled` – Булевый флаг чтобы включить функциональность, по умолчанию `false`. Установите `true` чтобы разрешить отправку отчетов о сбоях.
+- `endpoint` – Вы можете переопределить URL на который будут отсылаться отчеты об ошибках и использовать собственную инсталяцию Sentry. Используйте URL синтаксис [Sentry DSN](https://docs.sentry.io/error-reporting/quickstart/?platform=native#configure-the-sdk).
+- `anonymize` - Запретить отсылку имени хоста сервера в отчете о сбое.
+- `http_proxy` - Настройка HTTP proxy для отсылки отчетов о сбоях.
+- `debug` - Настроить клиентскую библиотеку Sentry в debug режим.
+- `tmp_path` - Путь в файловой системе для временного хранения состояния отчетов о сбоях перед отправкой на сервер Sentry.
+
+**Рекомендованые настройки**
+
+``` xml
+
+ true
+
+```
## macros {#macros}
@@ -362,19 +393,9 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
5368709120
```
-## max\_concurrent\_queries {#max-concurrent-queries}
+## max\_server\_memory\_usage {#max_server_memory_usage}
-Максимальное количество одновременно обрабатываемых запросов.
-
-**Пример**
-
-``` xml
-100
-```
-
-## max_server_memory_usage {#max_server_memory_usage}
-
-Ограничивает объём оперативной памяти, используемой сервером ClickHouse.
+Ограничивает объём оперативной памяти, используемой сервером ClickHouse. Настройка может быть задана только для профиля `default`.
Возможные значения:
@@ -389,7 +410,8 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
**См. также**
-- [max_memory_usage](../settings/query-complexity.md#settings_max_memory_usage)
+- [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}
@@ -416,6 +438,16 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
- [max_server_memory_usage](#max_server_memory_usage)
+## max\_concurrent\_queries {#max-concurrent-queries}
+
+Максимальное количество одновременно обрабатываемых запросов.
+
+**Пример**
+
+``` xml
+100
+```
+
## max\_connections {#max-connections}
Максимальное количество входящих соединений.
@@ -458,6 +490,18 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
0
```
+## max\_thread\_pool\_size {#max-thread-pool-size}
+
+Максимальное кол-во потоков в глобальном пуле потоков.
+
+Default value: 10000.
+
+**Example**
+
+``` xml
+12000
+```
+
## merge\_tree {#server_configuration_parameters-merge_tree}
Тонкая настройка таблиц семейства [MergeTree](../../operations/server-configuration-parameters/settings.md).
@@ -533,15 +577,16 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
## part\_log {#server_configuration_parameters-part-log}
-Логирование событий, связанных с данными типа [MergeTree](../../operations/server-configuration-parameters/settings.md). Например, события добавления или мержа данных. Лог можно использовать для симуляции алгоритмов слияния, чтобы сравнивать их характеристики. Также, можно визуализировать процесс слияния.
+Логирование событий, связанных с данными типа [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md). Например, события добавления или мержа данных. Лог можно использовать для симуляции алгоритмов слияния, чтобы сравнивать их характеристики. Также, можно визуализировать процесс слияния.
-Запросы логируются не в отдельный файл, а в таблицу [system.part\_log](../../operations/server-configuration-parameters/settings.md#system_tables-part-log). Вы можете изменить название этой таблицы в параметре `table` (см. ниже).
+Запросы логируются не в отдельный файл, а в таблицу [system.part\_log](../../operations/system-tables/part_log.md#system_tables-part-log). Вы можете изменить название этой таблицы в параметре `table` (см. ниже).
При настройке логирования используются следующие параметры:
- `database` — имя базы данных;
- `table` — имя таблицы;
-- `partition_by` — устанавливает [произвольный ключ партиционирования](../../operations/server-configuration-parameters/settings.md);
+- `partition_by` — устанавливает [произвольный ключ партиционирования](../../operations/server-configuration-parameters/settings.md). Нельзя использовать если используется `engine`
+- `engine` - устанавливает [настройки MergeTree Engine](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) для системной таблицы. Нельзя использовать если используется `partition_by`.
- `flush_interval_milliseconds` — период сброса данных из буфера в памяти в таблицу.
**Пример**
@@ -594,15 +639,16 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
## query\_log {#server_configuration_parameters-query-log}
-Настройка логирования запросов, принятых с настройкой [log\_queries=1](../settings/settings.md).
+Настройка логирования запросов, принятых с настройкой [log\_queries=1](../../operations/settings/settings.md).
-Запросы логируются не в отдельный файл, а в системную таблицу [system.query\_log](../../operations/server-configuration-parameters/settings.md#system_tables-query_log). Вы можете изменить название этой таблицы в параметре `table` (см. ниже).
+Запросы логируются не в отдельный файл, а в системную таблицу [system.query\_log](../../operations/system-tables/query_log.md#system_tables-query_log). Вы можете изменить название этой таблицы в параметре `table` (см. ниже).
При настройке логирования используются следующие параметры:
- `database` — имя базы данных;
- `table` — имя таблицы, куда будет записываться лог;
-- `partition_by` — [произвольный ключ партиционирования](../../operations/server-configuration-parameters/settings.md) для таблицы с логами;
+- `partition_by` — устанавливает [произвольный ключ партиционирования](../../operations/server-configuration-parameters/settings.md). Нельзя использовать если используется `engine`
+- `engine` - устанавливает [настройки MergeTree Engine](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) для системной таблицы. Нельзя использовать если используется `partition_by`.
- `flush_interval_milliseconds` — период сброса данных из буфера в памяти в таблицу.
Если таблица не существует, то ClickHouse создаст её. Если структура журнала запросов изменилась при обновлении сервера ClickHouse, то таблица со старой структурой переименовывается, а новая таблица создается автоматически.
@@ -613,7 +659,7 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
system
- toMonday(event_date)
+ Engine = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_date + INTERVAL 30 day
7500
```
@@ -622,13 +668,14 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
Настройка логирования потоков выполнения запросов, принятых с настройкой [log\_query\_threads=1](../settings/settings.md#settings-log-query-threads).
-Запросы логируются не в отдельный файл, а в системную таблицу [system.query\_thread\_log](../../operations/server-configuration-parameters/settings.md#system_tables-query_thread_log). Вы можете изменить название этой таблицы в параметре `table` (см. ниже).
+Запросы логируются не в отдельный файл, а в системную таблицу [system.query\_thread\_log](../../operations/system-tables/query_thread_log.md#system_tables-query_thread_log). Вы можете изменить название этой таблицы в параметре `table` (см. ниже).
При настройке логирования используются следующие параметры:
- `database` — имя базы данных;
- `table` — имя таблицы, куда будет записываться лог;
-- `partition_by` — [произвольный ключ партиционирования](../../operations/server-configuration-parameters/settings.md) для таблицы с логами;
+- `partition_by` — устанавливает [произвольный ключ партиционирования](../../operations/server-configuration-parameters/settings.md). Нельзя использовать если используется `engine`
+- `engine` - устанавливает [настройки MergeTree Engine](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) для системной таблицы. Нельзя использовать если используется `partition_by`.
- `flush_interval_milliseconds` — период сброса данных из буфера в памяти в таблицу.
Если таблица не существует, то ClickHouse создаст её. Если структура журнала запросов изменилась при обновлении сервера ClickHouse, то таблица со старой структурой переименовывается, а новая таблица создается автоматически.
@@ -644,15 +691,44 @@ ClickHouse проверит условия `min_part_size` и `min_part_size_rat
```
+## text\_log {#server_configuration_parameters-text_log}
+
+Настройка логирования текстовых сообщений в системную таблицу [text\_log](../../operations/system-tables/text_log.md#system_tables-text_log).
+
+Параметры:
+
+- `level` — Максимальный уровень сообщения (по умолчанию `Trace`) которое будет сохранено в таблице.
+- `database` — имя базы данных для хранения таблицы.
+- `table` — имя таблицы, куда будут записываться текстовые сообщения.
+- `partition_by` — устанавливает [произвольный ключ партиционирования](../../operations/server-configuration-parameters/settings.md). Нельзя использовать если используется `engine`
+- `engine` - устанавливает [настройки MergeTree Engine](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) для системной таблицы. Нельзя использовать если используется `partition_by`.
+- `flush_interval_milliseconds` — период сброса данных из буфера в памяти в таблицу.
+
+**Пример**
+```xml
+
+
+ notice
+ system
+
+ 7500
+
+ Engine = MergeTree PARTITION BY event_date ORDER BY event_time TTL event_date + INTERVAL 30 day
+
+
+```
+
+
## trace\_log {#server_configuration_parameters-trace_log}
-Settings for the [trace\_log](../../operations/server-configuration-parameters/settings.md#system_tables-trace_log) system table operation.
+Настройки для [trace\_log](../../operations/system-tables/trace_log.md#system_tables-trace_log) system table operation.
Parameters:
- `database` — Database for storing a table.
- `table` — Table name.
-- `partition_by` — [Custom partitioning key](../../operations/server-configuration-parameters/settings.md) for a system table.
+- `partition_by` — устанавливает [произвольный ключ партиционирования](../../operations/server-configuration-parameters/settings.md). Нельзя использовать если используется `engine`
+- `engine` - устанавливает [настройки MergeTree Engine](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-creating-a-table) для системной таблицы. Нельзя использовать если используется `partition_by`.
- `flush_interval_milliseconds` — Interval for flushing data from the buffer in memory to the table.
The default server configuration file `config.xml` contains the following settings section:
@@ -666,6 +742,36 @@ The default server configuration file `config.xml` contains the following settin
```
+## query\_masking\_rules {#query-masking-rules}
+
+Правила основанные на регурялных выражениях, которые будут применены для всех запросов а также для всех сообщений перед сохранением их в лог на сервере,
+`system.query_log`, `system.text_log`, `system.processes` таблицы, а также в логах отсылаемых клиенту. Это позволяет предотвратить
+утечку конфиденциальных данных из SQL запросов (такие как имена, электронные письма, личные идентификаторы или номера кредитных карт) в логи.
+
+**Пример**
+
+``` xml
+
+
+ hide SSN
+ (^|\D)\d{3}-\d{2}-\d{4}($|\D)
+ 000-00-0000
+
+
+```
+
+Параметры конфигурации:
+- `name` - имя правила (необязательно)
+- `regexp` - совместимое с RE2 регулярное выражение (обязательное)
+- `replace` - строка замены для конфиденциальных данных (опционально, по умолчанию - шесть звездочек)
+
+Правила маскировки применяются ко всему запросу (для предотвращения утечки конфиденциальных данных из неправильно оформленных / не интерпритируемых запросов).
+
+`system.events` таблица содержит счетчик `QueryMaskingRulesMatch` который считает общее кол-во совпадений правил маскировки.
+
+Для распределенных запросов каждый сервер должен быть сконфигурирован отдельно, иначе, подзапросы,
+переданные на другие узлы, будут сохраняться без маскировки.
+
## remote\_servers {#server-settings-remote-servers}
Конфигурация кластеров, которые использует движок таблиц [Distributed](../../operations/server-configuration-parameters/settings.md) и табличная функция `cluster`.
@@ -724,6 +830,10 @@ TCP порт для защищённого обмена данными с кли
Порт для взаимодействия с клиентами по протоколу MySQL.
+**Возможные значения**
+
+Положительное целое.
+
Пример
``` xml
@@ -742,7 +852,8 @@ TCP порт для защищённого обмена данными с кли
``` xml
/var/lib/clickhouse/tmp/
```
-## tmp_policy {#tmp-policy}
+
+## tmp\_policy {#tmp-policy}
Политика из [storage_configuration](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-multiple-volumes) для хранения временных файлов.
@@ -833,6 +944,7 @@ ClickHouse использует ZooKeeper для хранения метадан
2181
30000
+ 10000
/path/to/zookeeper/node
@@ -853,11 +965,11 @@ ClickHouse использует ZooKeeper для хранения метадан
- Глобально в разделе [merge\_tree](#server_configuration_parameters-merge_tree) файла `config.xml`.
- ClickHouse использует этот параметр для всех таблиц на сервере. Вы можете изменить настройку в любое время. Существующие таблицы изменяют свое поведение при изменении параметра.
+ ClickHouse использует этот параметр для всех таблиц на сервере. Вы можете изменить настройку в любое время. Существующие таблицы изменяют свое поведение при изменении параметра.
- Для каждой отдельной таблицы.
- При создании таблицы укажите соответствующую [настройку движка](../../operations/server_configuration_parameters/settings.md#table_engine-mergetree-creating-a-table). Поведение существующей таблицы с установленным параметром не изменяется даже при изменении глобального параметра.
+ При создании таблицы укажите соответствующую [настройку движка](../../operations/server-configuration-parameters/settings.md#table_engine-mergetree-creating-a-table). Поведение существующей таблицы с установленным параметром не изменяется даже при изменении глобального параметра.
**Возможные значения**
diff --git a/docs/ru/operations/system-tables/text_log.md b/docs/ru/operations/system-tables/text_log.md
index 984303b5f1f..01e34c914e6 100644
--- a/docs/ru/operations/system-tables/text_log.md
+++ b/docs/ru/operations/system-tables/text_log.md
@@ -1,4 +1,4 @@
-# system.text_log {#system-tables-text-log}
+# system.text_log {#system_tables-text_log}
Содержит записи логов. Уровень логирования для таблицы может быть ограничен параметром сервера `text_log.level`.
diff --git a/docs/ru/operations/system-tables/trace_log.md b/docs/ru/operations/system-tables/trace_log.md
index 12d33b7ba18..dec74b48487 100644
--- a/docs/ru/operations/system-tables/trace_log.md
+++ b/docs/ru/operations/system-tables/trace_log.md
@@ -1,33 +1,33 @@
# system.trace_log {#system_tables-trace_log}
-Contains stack traces collected by the sampling query profiler.
+Содержит экземпляры трассировки стека адресов вызова, собранные с помощью семплирующего профайлера запросов.
-ClickHouse creates this table when the [trace\_log](../server-configuration-parameters/settings.md#server_configuration_parameters-trace_log) server configuration section is set. Also the [query_profiler_real_time_period_ns](../settings/settings.md#query_profiler_real_time_period_ns) and [query_profiler_cpu_time_period_ns](../settings/settings.md#query_profiler_cpu_time_period_ns) settings should be set.
+ClickHouse создает эту таблицу когда утсановлена настройка [trace\_log](../server-configuration-parameters/settings.md#server_configuration_parameters-trace_log) в конфигурационном файле сервереа. А также настройки [query_profiler_real_time_period_ns](../settings/settings.md#query_profiler_real_time_period_ns) и [query_profiler_cpu_time_period_ns](../settings/settings.md#query_profiler_cpu_time_period_ns).
-To analyze logs, use the `addressToLine`, `addressToSymbol` and `demangle` introspection functions.
+Для анализа stack traces, используйте функции интроспекции `addressToLine`, `addressToSymbol` и `demangle`.
-Columns:
+Колонки:
-- `event_date`([Date](../../sql-reference/data-types/date.md)) — Date of sampling moment.
+- `event_date`([Date](../../sql-reference/data-types/date.md)) — Дата в момент снятия экземпляра стэка адресов вызова.
-- `event_time`([DateTime](../../sql-reference/data-types/datetime.md)) — Timestamp of sampling moment.
+- `event_time`([DateTime](../../sql-reference/data-types/datetime.md)) — Дата и время в момент снятия экземпляра стэка адресов вызова.
-- `revision`([UInt32](../../sql-reference/data-types/int-uint.md)) — ClickHouse server build revision.
+- `revision`([UInt32](../../sql-reference/data-types/int-uint.md)) — ревизия сборки сервера ClickHouse.
- When connecting to server by `clickhouse-client`, you see the string similar to `Connected to ClickHouse server version 19.18.1 revision 54429.`. This field contains the `revision`, but not the `version` of a server.
+ Во время соединения с сервером через `clickhouse-client`, вы видите строку похожую на `Connected to ClickHouse server version 19.18.1 revision 54429.`. Это поле содержит номер после `revision`, но не содержит строку после `version`.
-- `timer_type`([Enum8](../../sql-reference/data-types/enum.md)) — Timer type:
+- `timer_type`([Enum8](../../sql-reference/data-types/enum.md)) — Тип таймера:
- - `Real` represents wall-clock time.
- - `CPU` represents CPU time.
+ - `Real` означает wall-clock время.
+ - `CPU` означает относительное CPU время.
-- `thread_number`([UInt32](../../sql-reference/data-types/int-uint.md)) — Thread identifier.
+- `thread_number`([UInt32](../../sql-reference/data-types/int-uint.md)) — Идентификатор треда.
-- `query_id`([String](../../sql-reference/data-types/string.md)) — Query identifier that can be used to get details about a query that was running from the [query_log](#system_tables-query_log) system table.
+- `query_id`([String](../../sql-reference/data-types/string.md)) — Идентификатор запроса который может быть использован для получения деталей о запросе из таблицы [query_log](query_log.md#system_tables-query_log) system table.
-- `trace`([Array(UInt64)](../../sql-reference/data-types/array.md)) — Stack trace at the moment of sampling. Each element is a virtual memory address inside ClickHouse server process.
+- `trace`([Array(UInt64)](../../sql-reference/data-types/array.md)) — Трассировка стека адресов вызова в момент семплирования. Каждый элемент массива это адрес виртуальной памяти внутри процесса сервера ClickHouse.
-**Example**
+**Пример**
``` sql
SELECT * FROM system.trace_log LIMIT 1 \G
diff --git a/docs/tr/operations/system-tables.md b/docs/tr/operations/system-tables.md
index 7d8339a9c0f..9412669287c 100644
--- a/docs/tr/operations/system-tables.md
+++ b/docs/tr/operations/system-tables.md
@@ -532,7 +532,7 @@ Sütun:
- `query` (String) – The query text. For `INSERT`, eklemek için veri içermez.
- `query_id` (String) – Query ID, if defined.
-## sistem.text\_log {#system-tables-text-log}
+## sistem.text\_log {#system_tables-text_log}
Günlük girişleri içerir. Bu tabloya giden günlük seviyesi ile sınırlı olabilir `text_log.level` sunucu ayarı.
diff --git a/docs/zh/operations/settings/settings.md b/docs/zh/operations/settings/settings.md
index ec31b8e82bc..2befb7ee15d 100644
--- a/docs/zh/operations/settings/settings.md
+++ b/docs/zh/operations/settings/settings.md
@@ -1252,3 +1252,61 @@ ClickHouse生成异常
默认值:16。
[原始文章](https://clickhouse.tech/docs/en/operations/settings/settings/)
+
+## transform\_null\_in {#transform_null_in}
+
+为[IN](../../sql-reference/operators/in.md) 运算符启用[NULL](../../sql-reference/syntax.md#null-literal) 值的相等性。
+
+默认情况下,无法比较 `NULL` 值,因为 `NULL` 表示未定义的值。 因此,比较 `expr = NULL` 必须始终返回 `false`。 在此设置下,`NULL = NULL` 为IN运算符返回 `true`.
+
+可能的值:
+
+- 0 — 比较 `IN` 运算符中 `NULL` 值将返回 `false`。
+- 1 — 比较 `IN` 运算符中 `NULL` 值将返回 `true`。
+
+默认值:0。
+
+**例**
+
+考虑`null_in`表:
+
+``` text
+┌──idx─┬─────i─┐
+│ 1 │ 1 │
+│ 2 │ NULL │
+│ 3 │ 3 │
+└──────┴───────┘
+```
+
+查询:
+
+``` sql
+SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 0;
+```
+
+结果:
+
+``` text
+┌──idx─┬────i─┐
+│ 1 │ 1 │
+└──────┴──────┘
+```
+
+查询:
+
+``` sql
+SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;
+```
+
+结果:
+
+``` text
+┌──idx─┬─────i─┐
+│ 1 │ 1 │
+│ 2 │ NULL │
+└──────┴───────┘
+```
+
+**另请参阅**
+
+- [IN 运算符中的 NULL 处理](../../sql-reference/operators/in.md#in-null-processing)
diff --git a/docs/zh/operations/system-tables/text_log.md b/docs/zh/operations/system-tables/text_log.md
index 60c7a3ed90c..9643fbef358 100644
--- a/docs/zh/operations/system-tables/text_log.md
+++ b/docs/zh/operations/system-tables/text_log.md
@@ -3,7 +3,7 @@ machine_translated: true
machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
---
-# 系统。text\_log {#system-tables-text-log}
+# 系统。text\_log {#system_tables-text_log}
包含日志记录条目。 进入该表的日志记录级别可以通过以下方式进行限制 `text_log.level` 服务器设置。
diff --git a/docs/zh/sql-reference/syntax.md b/docs/zh/sql-reference/syntax.md
index a2ce1b5bac3..78cbd5660ac 100644
--- a/docs/zh/sql-reference/syntax.md
+++ b/docs/zh/sql-reference/syntax.md
@@ -89,15 +89,12 @@ CH只支持用单引号包含的字母。特殊字符可通过反斜杠进行转
在字符串中,你至少需要对 `'` 和 `\` 进行转义。单引号可以使用单引号转义,例如 `'It\'s'` 和 `'It''s'` 是相同的。
### 括号 {#compound}
+
数组都是使用方括号进行构造 `[1, 2, 3]`,元组则使用圆括号 `(1, 'Hello, world!', 2)`
-
从技术上来讲,这些都不是字符串,而是包含创建数组和元组运算符的表达式。
-
创建一个数组必须至少包含一个元素,创建一个元组至少包含2个元素
-
当元组出现在 `SELECT` 查询的 `IN` 部分时,是一种例外情形。查询结果可以包含元组,但是元组类型不能保存到数据库中(除非表采用 [内存表](../engines/table-engines/special/memory.md)引擎)
-
### NULL值 {#null-literal}
代表不存在的值