2020-05-06 06:13:29 +00:00
---
2022-04-09 13:29:05 +00:00
sidebar_label: Settings
sidebar_position: 55
2022-04-29 11:33:51 +00:00
slug: /ru/operations/settings/
2020-05-06 06:13:29 +00:00
---
# Настройки {#session-settings-intro}
2017-10-25 05:27:09 +00:00
В с е настройки, описанные ниже, могут быть заданы несколькими способами.
Настройки задаются послойно, т.е . каждый следующий слой перезаписывает предыдущие настройки.
2018-08-01 09:21:12 +00:00
Способы задания настроек, упорядоченные по приоритету:
2017-10-25 05:27:09 +00:00
2020-04-30 18:19:18 +00:00
- Настройки в конфигурационном файле сервера `users.xml` .
2017-10-25 05:27:09 +00:00
2020-04-30 18:19:18 +00:00
Устанавливаются в элементе `<profiles>` .
2017-10-25 05:27:09 +00:00
2020-04-30 18:19:18 +00:00
- Настройки для сессии.
2017-10-25 05:27:09 +00:00
2020-04-30 18:19:18 +00:00
Из консольного клиента ClickHouse в интерактивном режиме отправьте запрос `SET setting=value` .
Аналогично можно использовать ClickHouse-сессии в HTTP-протоколе, для этого необходимо указывать HTTP-параметр `session_id` .
2017-10-25 05:27:09 +00:00
2020-04-30 18:19:18 +00:00
- Настройки для запроса.
2018-08-01 09:21:12 +00:00
2020-04-30 18:19:18 +00:00
- При запуске консольного клиента ClickHouse в не интерактивном режиме установите параметр запуска `--setting=value` .
- При использовании HTTP API передавайте cgi-параметры (`URL?setting_1=value& setting_2=value...`).
2022-11-16 02:32:44 +00:00
- Укажите необходимые настройки в секции [SETTINGS ](../../sql-reference/statements/select/index.md#settings-in-select-query ) запроса SELECT. Эти настройки действуют только в рамках данного запроса, а после е г о выполнения сбрасываются до предыдущего значения или значения по умолчанию.
2017-10-25 05:27:09 +00:00
Настройки, которые можно задать только в конфигурационном файле сервера, в разделе не рассматриваются.
2018-10-16 10:47:17 +00:00
2020-10-15 17:27:17 +00:00
## Пользовательские настройки {#custom_settings}
2021-07-29 15:20:55 +00:00
В дополнение к общим [настройкам ](../../operations/settings/settings.md ), пользователи могут определять собственные настройки.
2020-10-15 17:27:17 +00:00
Название пользовательской настройки должно начинаться с одного из предопределённых префиксов. Список этих префиксов должен быть задан в параметре [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
2021-07-29 15:27:50 +00:00
SELECT getSetting('custom_a');
2020-10-15 17:27:17 +00:00
```
**См. также**
- [Конфигурационные параметры сервера ](../../operations/server-configuration-parameters/settings.md )