Docs for the mechanics of custom settings specifying (russian) (#15600)

Co-authored-by: Olga Revyakina <revolg@yandex-team.ru>
This commit is contained in:
olgarev 2020-10-15 20:27:17 +03:00 committed by GitHub
parent 939d8edf33
commit ab464350df
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 76 additions and 1 deletions

View File

@ -61,7 +61,21 @@ ClickHouse проверяет условия для `min_part_size` и `min_part
</compression>
```
## default_database {#default-database}
## custom_settings_prefixes {#custom_settings_prefixes}
Список префиксов для [пользовательских настроек](../../operations/settings/index.md#custom_settings). Префиксы должны перечисляться через запятую.
**Пример**
```xml
<custom_settings_prefixes>custom_</custom_settings_prefixes>
```
**См. также**
- [Пользовательские настройки](../../operations/settings/index.md#custom_settings)
## default\_database {#default-database}
База данных по умолчанию.

View File

@ -27,4 +27,30 @@ toc_title: "\u041d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0438"
Настройки, которые можно задать только в конфигурационном файле сервера, в разделе не рассматриваются.
## Пользовательские настройки {#custom_settings}
В дополнение к общим [настройкам](../../operations/settings/settings.md), пользователи могут определять собственные настройки.
Название пользовательской настройки должно начинаться с одного из предопределённых префиксов. Список этих префиксов должен быть задан в параметре [custom_settings_prefixes](../../operations/server-configuration-parameters/settings.md#custom_settings_prefixes) конфигурационнного файла сервера.
```xml
<custom_settings_prefixes>custom_</custom_settings_prefixes>
```
Чтобы задать значение пользовательской настройке, используйте команду `SET`:
```sql
SET custom_a = 123;
```
Чтобы получить текущее значение пользовательской настройки, используйте функцию `getSetting()`:
```sql
SELECT getSetting('custom_a');
```
**См. также**
- [Конфигурационные параметры сервера](../../operations/server-configuration-parameters/settings.md)
[Оригинальная статья](https://clickhouse.tech/docs/ru/operations/settings/) <!--hide-->

View File

@ -1431,6 +1431,41 @@ SELECT randomStringUTF8(13)
```
## getSetting {#getSetting}
Возвращает текущее значение [пользовательской настройки](../../operations/settings/index.md#custom_settings).
**Синтаксис**
```sql
getSetting('custom_setting');
```
**Параметр**
- `custom_setting` — название настройки. [String](../../sql-reference/data-types/string.md).
**Возвращаемое значение**
- Текущее значение пользовательской настройки.
**Пример**
```sql
SET custom_a = 123;
SELECT getSetting('custom_a');
```
**Результат**
```
123
```
**См. также**
- [Пользовательские настройки](../../operations/settings/index.md#custom_settings)
## isDecimalOverflow {#is-decimal-overflow}
Проверяет, находится ли число [Decimal](../../sql-reference/data-types/decimal.md#decimalp-s-decimal32s-decimal64s-decimal128s) вне собственной (или заданной) области значений.