mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-09-20 08:40:50 +00:00
Added RU docs for YAML configs
This commit is contained in:
parent
276c6b5be8
commit
04f7678617
@ -6,9 +6,9 @@ toc_title: "Конфигурационные файлы"
|
|||||||
|
|
||||||
# Конфигурационные файлы {#configuration_files}
|
# Конфигурационные файлы {#configuration_files}
|
||||||
|
|
||||||
Основной конфигурационный файл сервера - `config.xml`. Он расположен в директории `/etc/clickhouse-server/`.
|
Основной конфигурационный файл сервера - `config.xml` или `config.yaml`. Он расположен в директории `/etc/clickhouse-server/`.
|
||||||
|
|
||||||
Отдельные настройки могут быть переопределены в файлах `*.xml` и `*.conf` из директории `config.d` рядом с конфигом.
|
Отдельные настройки могут быть переопределены в файлах `*.xml` и `*.conf`, а также `.yaml` (для файлов в формате YAML) из директории `config.d` рядом с конфигом.
|
||||||
|
|
||||||
У элементов этих конфигурационных файлов могут быть указаны атрибуты `replace` или `remove`.
|
У элементов этих конфигурационных файлов могут быть указаны атрибуты `replace` или `remove`.
|
||||||
|
|
||||||
@ -25,7 +25,7 @@ toc_title: "Конфигурационные файлы"
|
|||||||
В элементе `users_config` файла `config.xml` можно указать относительный путь к конфигурационному файлу с настройками пользователей, профилей и квот. Значение `users_config` по умолчанию — `users.xml`. Если `users_config` не указан, то настройки пользователей, профилей и квот можно задать непосредственно в `config.xml`.
|
В элементе `users_config` файла `config.xml` можно указать относительный путь к конфигурационному файлу с настройками пользователей, профилей и квот. Значение `users_config` по умолчанию — `users.xml`. Если `users_config` не указан, то настройки пользователей, профилей и квот можно задать непосредственно в `config.xml`.
|
||||||
|
|
||||||
Настройки пользователя могут быть разделены в несколько отдельных файлов аналогичных `config.xml` и `config.d\`. Имя директории задаётся также как `users_config`.
|
Настройки пользователя могут быть разделены в несколько отдельных файлов аналогичных `config.xml` и `config.d\`. Имя директории задаётся также как `users_config`.
|
||||||
Имя директории задаётся так же, как имя файла в `users_config`, с подстановкой `.d` вместо `.xml`.
|
Имя директории задаётся так же, как имя файла в `users_config`, с подстановкой `.d` вместо `.xml`/`.yaml`.
|
||||||
Директория `users.d` используется по умолчанию, также как `users.xml` используется для `users_config`.
|
Директория `users.d` используется по умолчанию, также как `users.xml` используется для `users_config`.
|
||||||
Например, можно иметь по отдельному конфигурационному файлу для каждого пользователя:
|
Например, можно иметь по отдельному конфигурационному файлу для каждого пользователя:
|
||||||
|
|
||||||
@ -52,3 +52,66 @@ $ cat /etc/clickhouse-server/users.d/alice.xml
|
|||||||
|
|
||||||
Сервер следит за изменениями конфигурационных файлов, а также файлов и ZooKeeper-узлов, которые были использованы при выполнении подстановок и переопределений, и перезагружает настройки пользователей и кластеров на лету. То есть, можно изменять кластера, пользователей и их настройки без перезапуска сервера.
|
Сервер следит за изменениями конфигурационных файлов, а также файлов и ZooKeeper-узлов, которые были использованы при выполнении подстановок и переопределений, и перезагружает настройки пользователей и кластеров на лету. То есть, можно изменять кластера, пользователей и их настройки без перезапуска сервера.
|
||||||
|
|
||||||
|
## Примеры записи конфигурации на YAML {#example}
|
||||||
|
|
||||||
|
Здесь можно рассмотреть пример реальной конфигурации записанной на YAML: [config.yaml.example](https://github.com/ClickHouse/ClickHouse/blob/master/programs/server/config.yaml.example).
|
||||||
|
|
||||||
|
Между стандартами XML и YAML имеются различия, поэтому в этом разделе будут перечислены некоторые подсказки для написания конфигурации на YMAL.
|
||||||
|
|
||||||
|
Для записи обычной пары ключ-значение следует использовать Scalar:
|
||||||
|
``` yaml
|
||||||
|
key: value
|
||||||
|
```
|
||||||
|
|
||||||
|
Для создания тега, содержащего подтеги следует использовать Map:
|
||||||
|
``` yaml
|
||||||
|
map_key:
|
||||||
|
key1: val1
|
||||||
|
key2: val2
|
||||||
|
key3: val3
|
||||||
|
```
|
||||||
|
|
||||||
|
Для создания списка значений или подтегов, расположенных по определенному ключу, следует использовать Sequence:
|
||||||
|
``` yaml
|
||||||
|
seq_key:
|
||||||
|
- val1
|
||||||
|
- val2
|
||||||
|
- key1: val3
|
||||||
|
- map:
|
||||||
|
key2: val4
|
||||||
|
key3: val5
|
||||||
|
```
|
||||||
|
|
||||||
|
В случае, усли необходимо объявить тег, аналогичный XML-атрибуту, необходимо задать скаляр, имеющий ключ с префиксом @ и заключенный в кавычки:
|
||||||
|
|
||||||
|
``` yaml
|
||||||
|
map:
|
||||||
|
"@attr1": value1
|
||||||
|
"@attr2": value2
|
||||||
|
key: 123
|
||||||
|
```
|
||||||
|
|
||||||
|
Из такой Map мы получим после конвертации:
|
||||||
|
|
||||||
|
``` xml
|
||||||
|
<map attr1="value1" attr2="value2">
|
||||||
|
<key>123</key>
|
||||||
|
</map>
|
||||||
|
```
|
||||||
|
|
||||||
|
Помимо Map, можно задавать атрибуты для Sequence:
|
||||||
|
|
||||||
|
``` yaml
|
||||||
|
seq:
|
||||||
|
- "@attr1": value1
|
||||||
|
- "@attr2": value2
|
||||||
|
- 123
|
||||||
|
- abc
|
||||||
|
```
|
||||||
|
|
||||||
|
Таким образом получая аналог следующей записи на XML:
|
||||||
|
|
||||||
|
``` xml
|
||||||
|
<seq attr1="value1" attr2="value2">123</seq>
|
||||||
|
<seq attr1="value1" attr2="value2">abc</seq>
|
||||||
|
```
|
||||||
|
Loading…
Reference in New Issue
Block a user