mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-13 19:14:30 +00:00
9ec78855cd
* DOCSUP-2806: Add meta intro. * DOCSUP-2806: Update meta intro. * DOCSUP-2806: Fix meta. * DOCSUP-2806: Add quotes for meta headers. * DOCSUP-2806: Remove quotes from meta headers. * DOCSUP-2806: Add meta headers. * DOCSUP-2806: Fix quotes in meta headers. * DOCSUP-2806: Update meta headers. * DOCSUP-2806: Fix link to nowhere in EN. * DOCSUP-2806: Fix link (settings to tune) * DOCSUP-2806: Fix links. * DOCSUP-2806:Fix links EN * DOCSUP-2806: Fix build errors. * DOCSUP-2806: Fix meta intro. * DOCSUP-2806: Fix toc_priority in examples datasets TOC. * DOCSUP-2806: Fix items order in toc. * DOCSUP-2806: Fix order in toc. * DOCSUP-2806: Fix toc order. * DOCSUP-2806: Fix order in toc. * DOCSUP-2806: Fix toc index in create * DOCSUP-2806: Fix toc order in create. Co-authored-by: romanzhukov <romanzhukov@yandex-team.ru> Co-authored-by: alexey-milovidov <milovidov@yandex-team.ru>
57 lines
3.1 KiB
Markdown
57 lines
3.1 KiB
Markdown
---
|
||
toc_folder_title: Settings
|
||
toc_priority: 55
|
||
toc_title: Introduction
|
||
---
|
||
|
||
# Настройки {#session-settings-intro}
|
||
|
||
Все настройки, описанные ниже, могут быть заданы несколькими способами.
|
||
Настройки задаются послойно, т.е. каждый следующий слой перезаписывает предыдущие настройки.
|
||
|
||
Способы задания настроек, упорядоченные по приоритету:
|
||
|
||
- Настройки в конфигурационном файле сервера `users.xml`.
|
||
|
||
Устанавливаются в элементе `<profiles>`.
|
||
|
||
- Настройки для сессии.
|
||
|
||
Из консольного клиента ClickHouse в интерактивном режиме отправьте запрос `SET setting=value`.
|
||
Аналогично можно использовать ClickHouse-сессии в HTTP-протоколе, для этого необходимо указывать HTTP-параметр `session_id`.
|
||
|
||
- Настройки для запроса.
|
||
|
||
- При запуске консольного клиента ClickHouse в не интерактивном режиме установите параметр запуска `--setting=value`.
|
||
- При использовании HTTP API передавайте cgi-параметры (`URL?setting_1=value&setting_2=value...`).
|
||
|
||
Настройки, которые можно задать только в конфигурационном файле сервера, в разделе не рассматриваются.
|
||
|
||
## Пользовательские настройки {#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-->
|