Перейти к основному содержимому
Перейти к основному содержимому

Настройки сессии на уровне запроса

Существует несколько способов выполнения операторов с определенными настройками. Настройки конфигурируются по слоям, и каждый следующий слой перекрывает предыдущие значения настройки.

Порядок приоритета для определения настройки:

  1. Применение настройки к пользователю напрямую или в рамках профиля настроек

    • SQL (рекомендуется)
    • добавление одного или нескольких XML или YAML файлов в /etc/clickhouse-server/users.d

  2. Настройки сессии

    • Отправить SET setting=value из консоли ClickHouse Cloud SQL или clickhouse client в интерактивном режиме. Аналогично, вы можете использовать сессии ClickHouse в HTTP-протоколе. Для этого необходимо указать HTTP-параметр session_id.

  3. Настройки запросов

    • При запуске clickhouse client в неинтерактивном режиме установите параметр запуска --setting=value.
    • При использовании HTTP API передайте параметры CGI (URL?setting_1=value&setting_2=value...).
    • Определите настройки в SETTINGS разделе SELECT запроса. Значение настройки применяется только к этому запросу и сбрасывается на значение по умолчанию или предыдущее значение после выполнения запроса.

Примеры​

Все эти примеры устанавливают значение настройки async_insert в 1 и показывают, как проверить настройки в работающей системе.

Использование SQL для применения настройки к пользователю напрямую​

Это создает пользователя ingester с настройкой async_inset = 1:

Проверка профиля настроек и назначения​

Использование SQL для создания профиля настроек и назначения его пользователю​

Это создает профиль log_ingest с настройкой async_inset = 1:

Это создает пользователя ingester и назначает ему профиль настроек log_ingest:

Использование XML для создания профиля настроек и пользователя​

Проверка профиля настроек и назначения​

Назначение настройки сессии​

Назначение настройки во время запроса​

Приведение настройки к значению по умолчанию​

Если вы изменили настройку и хотите вернуть ее к значению по умолчанию, установите значение в DEFAULT. Синтаксис выглядит следующим образом:

Например, значение по умолчанию для async_insert равно 0. Предположим, вы изменили его значение на 1:

Ответ будет:

Следующая команда устанавливает его значение обратно на 0:

Настройка теперь вернулась к своему значению по умолчанию:

Пользовательские настройки​

Кроме общих настроек, пользователи могут определять пользовательские настройки.

Имя пользовательской настройки должно начинаться с одного из предопределенных префиксов. Список этих префиксов должен быть объявлен в параметре custom_settings_prefixes в файле конфигурации сервера.

Чтобы определить пользовательскую настройку, используйте команду SET:

Чтобы получить текущее значение пользовательской настройки, используйте функцию getSetting():

Смотрите также