2020-05-06 06:13:29 +00:00
---
2020-10-26 10:29:30 +00:00
toc_folder_title: Settings
2020-05-06 06:13:29 +00:00
toc_priority: 55
2020-10-26 10:29:30 +00:00
toc_title: Introduction
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...`).
2021-01-16 19:34:13 +00:00
- Укажите необходимые настройки в секции [SETTINGS ](../../sql-reference/statements/select/index.md#settings-in-select ) запроса 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}
В дополнение к общим [настройкам ](../../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 )