SET

SET param = value

将 value 赋值给当前会话的 param 设置。你无法通过这种方式更改服务器设置。

你也可以在单条查询中设置指定 profile 中的所有值。

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'

设置会话时区。这是 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');

The timezone value must be a valid name from the IANA Time Zone Database. An invalid timezone name will result in an error.

有关 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。