Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

DOCSUP-1352: [CLICKHOUSEDOCS] Edit and translate to Russian #13891

Merged
merged 12 commits into from
Aug 31, 2020
+211 −92
Merged

DOCSUP-1352: [CLICKHOUSEDOCS] Edit and translate to Russian #13891

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
41cb15e
first commit
dfenelonov Aug 19, 2020
f606cc6
second commit
dfenelonov Aug 19, 2020
28ee434
Third commit
dfenelonov Aug 19, 2020
f3633f4
Fourth commit
dfenelonov Aug 19, 2020
92ae815
array-functions.md
dfenelonov Aug 22, 2020
838f090
Sixth commit
dfenelonov Aug 22, 2020
c25cee6
Seventh commit
dfenelonov Aug 22, 2020
e5ad378
Eigth commit
dfenelonov Aug 22, 2020
2ec8643
Ninth commit
dfenelonov Aug 22, 2020
90de837
tenth commit
dfenelonov Aug 29, 2020
b2af058
eleventh commit
dfenelonov Aug 29, 2020
2f9d8d6
twelfth commit
dfenelonov Aug 29, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/ru/interfaces/third-party/gui.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,10 @@

[clickhouse-flamegraph](https://github.com/Slach/clickhouse-flamegraph) — специализированный инструмент для визуализации `system.trace_log` в виде [flamegraph](http://www.brendangregg.com/flamegraphs.html).

### clickhouse-plantuml {#clickhouse-plantuml}

[cickhouse-plantuml](https://pypi.org/project/clickhouse-plantuml/) — скрипт, генерирующий [PlantUML](https://plantuml.com/) диаграммы схем таблиц.

## Коммерческие {#kommercheskie}

### DataGrip {#datagrip}
Expand Down
7 changes: 5 additions & 2 deletions docs/ru/operations/configuration-files.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,12 @@

Подстановки могут также выполняться из ZooKeeper. Для этого укажите у элемента атрибут `from_zk = "/path/to/node"`. Значение элемента заменится на содержимое узла `/path/to/node` в ZooKeeper. В ZooKeeper-узел также можно положить целое XML-поддерево, оно будет целиком вставлено в исходный элемент.

В `config.xml` может быть указан отдельный конфиг с настройками пользователей, профилей и квот. Относительный путь к нему указывается в элементе users\_config. По умолчанию - `users.xml`. Если `users_config` не указан, то настройки пользователей, профилей и квот, указываются непосредственно в `config.xml`.
В элементе `users_config` файла `config.xml` можно указать относительный путь к конфигурационному файлу с настройками пользователей, профилей и квот. Значение `users_config` по умолчанию — `users.xml`. Если `users_config` не указан, то настройки пользователей, профилей и квот можно задать непосредственно в `config.xml`.

Для `users_config` могут также существовать переопределения в файлах из директории `users_config.d` (например, `users.d`) и подстановки. Например, можно иметь по отдельному конфигурационному файлу для каждого пользователя:
Настройки пользователя могут быть разделены в несколько отдельных файлов аналогичных `config.xml` и `config.d\`. Имя директории задаётся также как `users_config`.
Имя директории задаётся так же, как имя файла в `users_config`, с подстановкой `.d` вместо `.xml`.
Директория `users.d` используется по умолчанию, также как `users.xml` используется для `users_config`.
Например, можно иметь по отдельному конфигурационному файлу для каждого пользователя:

``` bash
$ cat /etc/clickhouse-server/users.d/alice.xml
Expand Down
109 changes: 72 additions & 37 deletions docs/ru/operations/settings/settings.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -520,41 +520,70 @@ ClickHouse использует этот параметр при чтении д

Значение по умолчанию: 0.

## network_compression_method {#network_compression_method}
## log\_queries {#settings-log-queries}

Задает метод сжатия данных, используемый при обмене данными между серверами и при обмене между сервером и [clickhouse-client](../../interfaces/cli.md).
Установка логирования запроса.

Возможные значения:
Запросы, переданные в ClickHouse с этой установкой, логируются согласно правилам конфигурационного параметра сервера [query\_log](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-query-log).

Пример:

- `LZ4` — устанавливает метод сжатия LZ4.
- `ZSTD` — устанавливает метод сжатия ZSTD.
``` text
log_queries=1
```

Значение по умолчанию: `LZ4`.
## log\_queries\_min\_type {#settings-log-queries-min-type}

См. также:
`query_log` минимальный уровень логирования.

- [network_zstd_compression_level](#network_zstd_compression_level)
Возможные значения:
- `QUERY_START` (`=1`)
- `QUERY_FINISH` (`=2`)
- `EXCEPTION_BEFORE_START` (`=3`)
- `EXCEPTION_WHILE_PROCESSING` (`=4`)

## network_zstd_compression_level {#network_zstd_compression_level}
Значение по умолчанию: `QUERY_START`.

Регулирует уровень сжатия ZSTD. Используется только тогда, когда [network_compression_method](#network_compression_method) имеет значение `ZSTD`.
Можно использовать для ограничения того, какие объекты будут записаны в `query_log`, например, если вас интересуют ошибки, тогда вы можете использовать `EXCEPTION_WHILE_PROCESSING`:

``` text
log_queries_min_type='EXCEPTION_WHILE_PROCESSING'
```

## log\_queries\_min\_type {#settings-log-queries-min-type}

`query_log` минимальный уровень логирования.

Возможные значения:
- `QUERY_START` (`=1`)
- `QUERY_FINISH` (`=2`)
- `EXCEPTION_BEFORE_START` (`=3`)
- `EXCEPTION_WHILE_PROCESSING` (`=4`)

- Положительное целое число от 1 до 15.
Значение по умолчанию: `QUERY_START`.

Значение по умолчанию: `1`.
Можно использовать для ограничения того, какие объекты будут записаны в `query_log`, например, если вас интересуют ошибки, тогда вы можете использовать `EXCEPTION_WHILE_PROCESSING`:

## log\_queries {#settings-log-queries}
``` text
log_queries_min_type='EXCEPTION_WHILE_PROCESSING'
```

Установка логирования запроса.
## log\_queries\_min\_type {#settings-log-queries-min-type}

Запросы, переданные в ClickHouse с этой установкой, логируются согласно правилам конфигурационного параметра сервера [query\_log](../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-query-log).
Задаёт минимальный уровень логирования в `query_log`.

Пример:
Возможные значения:
- `QUERY_START` (`=1`)
- `QUERY_FINISH` (`=2`)
- `EXCEPTION_BEFORE_START` (`=3`)
- `EXCEPTION_WHILE_PROCESSING` (`=4`)

Значение по умолчанию: `QUERY_START`.

Можно использовать для ограничения того, какие объекты будут записаны в `query_log`, например, если вас интересуют ошибки, тогда вы можете использовать `EXCEPTION_WHILE_PROCESSING`:

``` text
log_queries=1
log_queries_min_type='EXCEPTION_WHILE_PROCESSING'
```

## log\_query\_threads {#settings-log-query-threads}
Expand All @@ -571,7 +600,7 @@ log_query_threads=1

## max\_insert\_block\_size {#settings-max_insert_block_size}

Формировать блоки указанного размера (в количестве строк), при вставке в таблицу.
Формировать блоки указанного размера, при вставке в таблицу.
Эта настройка действует только в тех случаях, когда сервер сам формирует такие блоки.
Например, при INSERT-е через HTTP интерфейс, сервер парсит формат данных, и формирует блоки указанного размера.
А при использовании clickhouse-client, клиент сам парсит данные, и настройка max\_insert\_block\_size на сервере не влияет на размер вставляемых блоков.
Expand Down Expand Up @@ -946,7 +975,6 @@ SELECT area/period FROM account_orders FORMAT JSON;
"type": "Float64"
}
],

"data":
[
{
Expand All @@ -959,9 +987,7 @@ SELECT area/period FROM account_orders FORMAT JSON;
"divide(area, period)": null
}
],

"rows": 3,

"statistics":
{
"elapsed": 0.003648093,
Expand All @@ -982,7 +1008,6 @@ SELECT area/period FROM account_orders FORMAT JSON;
"type": "Float64"
}
],

"data":
[
{
Expand All @@ -995,9 +1020,7 @@ SELECT area/period FROM account_orders FORMAT JSON;
"divide(area, period)": "-inf"
}
],

"rows": 3,

"statistics":
{
"elapsed": 0.000070241,
Expand All @@ -1007,6 +1030,7 @@ SELECT area/period FROM account_orders FORMAT JSON;
}
```


## format\_csv\_delimiter {#settings-format_csv_delimiter}

Символ, интерпретируемый как разделитель в данных формата CSV. По умолчанию — `,`.
Expand Down Expand Up @@ -1220,7 +1244,7 @@ ClickHouse генерирует исключение

Значение по умолчанию: 0

## force\_optimize\_skip\_unused\_shards {#force-optimize-skip-unused-shards}
## force\_optimize\_skip\_unused\_shards {#settings-force_optimize_skip_unused_shards}

Разрешает или запрещает выполнение запроса, если настройка [optimize_skip_unused_shards](#optimize-skip-unused-shards) включена, а пропуск неиспользуемых шардов невозможен. Если данная настройка включена и пропуск невозможен, ClickHouse генерирует исключение.

Expand All @@ -1234,19 +1258,30 @@ ClickHouse генерирует исключение

## force\_optimize\_skip\_unused\_shards\_nesting {#settings-force_optimize_skip_unused_shards_nesting}

Контролирует настройку [`force_optimize_skip_unused_shards`](#force-optimize-skip-unused-shards) (поэтому все еще требует `optimize_skip_unused_shards`) в зависимости от вложенности распределенного запроса (когда у вас есть `Distributed` таблица которая смотрит на другую `Distributed` таблицу).
Контролирует настройку [`force_optimize_skip_unused_shards`](#settings-force_optimize_skip_unused_shards) (поэтому все еще требует `optimize_skip_unused_shards`) в зависимости от вложенности распределенного запроса (когда у вас есть `Distributed` таблица которая смотрит на другую `Distributed` таблицу).

Возможные значения:

- 0 - Disabled, `force_optimize_skip_unused_shards` works on all levels.
- 1 — Enables `force_optimize_skip_unused_shards` only for the first level.
- 2 — Enables `force_optimize_skip_unused_shards` up to the second level.
- 0 - Выключена, `force_optimize_skip_unused_shards` работает всегда.
- 1 — Включает `force_optimize_skip_unused_shards` только для 1-ого уровня вложенности.
- 2 — Включает `force_optimize_skip_unused_shards` для 1-ого и 2-ого уровня вложенности.

Значение по умолчанию: 0

## force\_optimize\_skip\_unused\_shards\_no\_nested {#settings-force_optimize_skip_unused_shards_no_nested}

Сбрасывает [`optimize_skip_unused_shards`](#settings-force_optimize_skip_unused_shards) для вложенных `Distributed` таблиц.

Возможные значения:

- 1 — Включена.
- 0 — Выключена.

Значение по умолчанию: 0

## optimize\_throw\_if\_noop {#setting-optimize_throw_if_noop}

Включает или отключает генерирование исключения в в случаях, когда запрос [OPTIMIZE](../../sql-reference/statements/misc.md#misc_operations-optimize) не выполняет мёрж.
Включает или отключает генерирование исключения в случаях, когда запрос [OPTIMIZE](../../sql-reference/statements/misc.md#misc_operations-optimize) не выполняет мёрж.

По умолчанию, `OPTIMIZE` завершается успешно и в тех случаях, когда он ничего не сделал. Настройка позволяет отделить подобные случаи и включает генерирование исключения с поясняющим сообщением.

Expand Down Expand Up @@ -1367,7 +1402,7 @@ Default value: 0.
- [Sampling Query Profiler](../optimizing-performance/sampling-query-profiler.md)
- System table [trace\_log](../../operations/system-tables/trace_log.md#system_tables-trace_log)

## background_pool_size {#background_pool_size}
## background\_pool\_size {#background_pool_size}

Задает количество потоков для выполнения фоновых операций в движках таблиц (например, слияния в таблицах c движком [MergeTree](../../engines/table-engines/mergetree-family/index.md)). Настройка применяется при запуске сервера ClickHouse и не может быть изменена во пользовательском сеансе. Настройка позволяет управлять загрузкой процессора и диска. Чем меньше пулл, тем ниже нагрузка на CPU и диск, при этом фоновые процессы замедляются, что может повлиять на скорость выполнения запроса.

Expand All @@ -1381,7 +1416,7 @@ Default value: 0.

Включает параллельную обработку распределённых запросов `INSERT ... SELECT`.

Если при выполнении запроса `INSERT INTO distributed_table_a SELECT ... FROM distributed_table_b` оказывается, что обе таблицы находятся в одном кластере, то независимо от того [реплицируемые](../../engines/table-engines/mergetree-family/replication.md) они или нет, запрос выполняется локально на каждом шарде.
Если при выполнении запроса `INSERT INTO distributed_table_a SELECT ... FROM distributed_table_b` оказывается, что обе таблицы находятся в одном кластере, то независимо от того [реплицируемые](../../engines/table-engines/mergetree-family/replication.md) они или нет, запрос выполняется локально на каждом шарде.

Допустимые значения:

Expand Down Expand Up @@ -1431,7 +1466,7 @@ Default value: 0.

Значение по умолчанию: 0.

**См. также:**
**См. также:**

- [Репликация данных](../../engines/table-engines/mergetree-family/replication.md)

Expand All @@ -1448,7 +1483,7 @@ Possible values:

Значение по умолчанию: 0.

**Пример**
**Пример**

Рассмотрим таблицу `null_in`:

Expand Down Expand Up @@ -1499,7 +1534,7 @@ SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;
└──────┴───────┘
```

**См. также**
**См. также**

- [Обработка значения NULL в операторе IN](../../sql-reference/operators/in.md#in-null-processing)

Expand Down Expand Up @@ -1610,8 +1645,8 @@ SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;

Возможные значения:

- 0 - мутации выполняются асинхронно.
- 1 - запрос ждет завершения всех мутаций на текущем сервере.
- 0 - мутации выполняются асинхронно.
- 1 - запрос ждет завершения всех мутаций на текущем сервере.
- 2 - запрос ждет завершения всех мутаций на всех репликах (если они есть).

Значение по умолчанию: `0`.
Expand Down