SET

SET param = value

Присваивает value параметру param настройки для текущего сеанса. Этим способом нельзя изменить настройки сервера.

Вы также можете задать все значения из указанного профиля настроек одним запросом.

SET profile = 'profile-name-from-the-settings-file'

Для булевых настроек со значением true можно использовать сокращённый синтаксис, опустив присваивание значения. Если указано только имя настройки, ей автоматически присваивается значение 1 (true).

-- These are equivalent:
SET force_index_by_date = 1
SET force_index_by_date

SET TIME ZONE [=] 'timezone'

Устанавливает часовой пояс сеанса. Это alias для SET session_timezone = 'timezone', предусмотренный для совместимости с PostgreSQL и другими SQL-базами данных.

Многие SQL-клиенты, ORM и драйверы JDBC автоматически выполняют SET TIME ZONE при подключении. Этот синтаксис позволяет таким инструментам работать с ClickHouse без дополнительных обходных решений.

SET TIME ZONE 'UTC';
SET TIME ZONE 'Europe/Amsterdam';
SET TIME ZONE 'America/New_York';

-- Verify the current session time zone
SELECT getSetting('session_timezone');

Значение часового пояса должно быть корректным именем из базы данных часовых поясов IANA. Некорректное имя часового пояса приведёт к ошибке.

Дополнительные сведения о настройке session_timezone см. в разделе session_timezone.

Оператор SET также можно использовать для задания параметров запроса, добавив префикс param_ к имени параметра. Параметры запроса позволяют писать универсальные запросы с плейсхолдерами, которые подставляются фактическими значениями во время выполнения.

SET param_name = value

Чтобы использовать параметр запроса в запросе, укажите его в формате {name: datatype}:

SET param_id = 42;
SET param_name = 'John';

SELECT * FROM users
WHERE id = {id: UInt32}
AND name = {name: String};

Параметры запроса особенно полезны, когда один и тот же запрос нужно выполнить несколько раз с разными значениями.

Более подробную информацию о параметрах запроса, включая их использование с типом Identifier, см. в разделе Определение и использование параметров запроса.

Дополнительные сведения см. в разделе Settings.