SETTINGS 子句
引入或更新: v1.2.652
SETTINGS 子句配置特定的设置，这些设置会影响其前面的 SQL 语句的执行行为。要查看 Databend 中可用的设置及其值，请使用 SHOW SETTINGS。
另请参阅: SET
语法
SETTINGS ( <setting> = <value> [, <setting> = <value>, ...] ) <statement>
支持的语句
SETTINGS 子句可以与以下 SQL 语句一起使用：
- SELECT
- INSERT
- INSERT (多表)
- MERGE
COPY INTO <table>COPY INTO <location>- UPDATE
- DELETE
- CREATE TABLE
- EXPLAIN
示例
此示例展示了如何使用 SETTINGS 子句在 SELECT 查询中调整时区参数，影响 now() 显示的结果：
-- 当未设置时区时，Databend 默认使用 UTC，因此 now() 返回当前的 UTC 时间戳
SELECT timezone(), now();
┌─────────────────────────────────────────┐
│ timezone() │ now() │
│ String │ Timestamp │
├────────────┼────────────────────────────┤
│ UTC │ 2024-11-04 19:42:28.424925 │
└─────────────────────────────────────────┘
-- 通过将时区设置为 Asia/Shanghai，now() 函数返回上海的本地时间，比 UTC 快 8 小时。
SETTINGS (timezone = 'Asia/Shanghai') SELECT timezone(), now();
┌────────────────────────────────────────────┐
│ timezone() │ now() │
├───────────────┼────────────────────────────┤
│ Asia/Shanghai │ 2024-11-05 03:42:42.209404 │
└────────────────────────────────────────────┘
-- 将时区设置为 America/Toronto 调整 now() 输出为多伦多的本地时间，反映东部时区（UTC-5 或夏令时期间的 UTC-4）。
SETTINGS (timezone = 'America/Toronto') SELECT timezone(), now();
┌──────────────────────────────────────────────┐
│ timezone() │ now() │
│ String │ Timestamp │
├─────────────────┼────────────────────────────┤
│ America/Toronto │ 2024-11-04 14:42:48.353577 │
└──────────────────────────────────────────────┘
此示例允许 COPY INTO 操作使用最多 100 个线程进行并行处理：
SETTINGS (max_threads = 100) COPY INTO ...
