-
Применение настройки непосредственно к пользователю или в профиле настроек
- SQL (рекомендуется)
- добавление одного или нескольких XML- или YAML-файлов в
/etc/clickhouse-server/users.d
-
Настройки сеанса
- Отправьте
SET setting=valueиз SQL-консоли ClickHouse Cloud или черезclickhouse clientв интерактивном режиме. Аналогичным образом можно использовать сеансы ClickHouse в HTTP-протоколе. Для этого необходимо указать HTTP-параметрsession_id.
- Отправьте
-
Настройки запроса
- При запуске
clickhouse clientв неинтерактивном режиме задайте параметр запуска--setting=value. - При использовании HTTP API передавайте CGI-параметры (
URL?setting_1=value&setting_2=value...). - Задайте настройки в секции SETTINGS запроса SELECT. Значение настройки применяется только к этому запросу и после его выполнения сбрасывается до значения по умолчанию или предыдущего значения.
- При запуске
DEFAULT. Синтаксис выглядит так:
async_insert по умолчанию — 0. Предположим, вы изменили его на 1:
- Фильтровать данные по идентификатору пользователя или организации
- Применять различную бизнес-логику в зависимости от контекста
- Сохранять информацию о состоянии между запросами в рамках сеанса
custom_settings_prefixes, заданной в файле конфигурации сервера.
В примере ниже в качестве пользовательского префикса выбран SQL_:
В ClickHouse Cloud невозможно указать собственный префикс.
Все пользовательские настройки начинаются с префикса
SQL_.SET:
getSetting():
async_insert установлено в 1, а
также показано, как просматривать настройки в работающей системе.
Это создаст пользователя ingester с настройкой async_inset = 1:
log_ingest с настройкой async_inset = 1:
ingester и назначает ему профиль настроек log_ingest:
/etc/clickhouse-server/users.d/users.xml
- Описание настроек ClickHouse приведено на странице Настройки.
- Глобальные настройки сервера