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

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

时区值必须是 system.time_zones 中列出的名称 (即服务器随附的 IANA 时区数据库中的名称) ，或采用 Fixed/UTC±HH:MM:SS 格式的固定偏移量。任何其他值，包括仅存在于操作系统时区数据库中的名称，都会导致错误。有关 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。

SQL 参考文档

数据类型

引擎

函数

格式

设置

系统表

数据湖

SET TIME ZONE

设置查询参数

​SET TIME ZONE

​设置查询参数

SET TIME ZONE

设置查询参数