SET 语句

SET 语句说明

SET param = value

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

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

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

对于值为 true 的布尔设置，可以使用简写语法，省略值赋值。只指定设置名称时，会自动设为 1 (true) 。

-- 以下两种写法等价：
SET force_index_by_date = 1
SET force_index_by_date

​

SET TIME ZONE

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';

-- 验证当前会话时区
SELECT getSetting('session_timezone');

timezone 值必须是 IANA Time Zone Database 中的有效名称。无效的 timezone 名称会导致 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。