`，前提是归档文件具有正确的扩展名。
## allow\_asynchronous\_read\_from\_io\_pool\_for\_merge\_tree
使用后台 I/O 线程池从 MergeTree 表中读取数据。此设置可能会提高受 I/O 限制的查询的性能
## allow\_calculating\_subcolumns\_sizes\_for\_merge\_tree\_reading
启用后，ClickHouse 将计算读取每个子列所需文件的大小，以便更准确地计算任务大小和块大小。
## allow\_changing\_replica\_until\_first\_data\_packet
如果启用，在对冲请求中，即使已经有了一些进度，也可以在收到第一个数据包之前发起新的连接
(但在 `receive_data_timeout` 超时时间内进度没有更新) ；否则，一旦首次取得进度，就会禁止切换副本。
## allow\_create\_index\_without\_type
允许执行不带 TYPE 的 CREATE INDEX 查询。该查询会被忽略。此设置用于 SQL 兼容性测试。
## allow\_custom\_error\_code\_in\_throwif
在 throwIf() 函数中启用自定义错误代码。如果为 true，抛出的异常可能带有非预期的错误代码。
## allow\_ddl
如果设置为 true，则用户可以执行 DDL 查询。
## allow\_delta\_kernel\_rs
**别名**：`allow_experimental_delta_kernel_rs`
允许使用 `delta-kernel-rs` 实现读取 Delta Lake 表。
## allow\_distinct\_partitions\_independently
当分区表达式是 `DISTINCT` 列的确定性函数时，启用在独立线程中按分区计算 `DISTINCT`，从而跳过跨流合并。当分区数接近 CPU 核心数且各分区大小大致相同时，此设置会带来收益；否则，成本启发式策略会跳过此优化。请参阅 [max\_number\_of\_partitions\_for\_independent\_distinct](/zh/reference/settings/session-settings/max-number#max_number_of_partitions_for_independent_distinct) 和 [force\_distinct\_partitions\_independently](/zh/reference/settings/session-settings/force#force_distinct_partitions_independently)。不适用于 `FINAL` 或并行副本。
设置 [max\_rows\_in\_distinct](/zh/reference/settings/session-settings/max-rows#max_rows_in_distinct) 或 [max\_bytes\_in\_distinct](/zh/reference/settings/session-settings/max-bytes#max_bytes_in_distinct) 时，不会应用此设置：这些限制由可见整个合并结果的单个 `DISTINCT` 转换执行，因此会保留跨流合并，以确保其全局语义。
## allow\_distributed\_ddl
如果设置为 true，则允许用户执行分布式 DDL 查询。
## allow\_drop\_detached
允许执行 ALTER TABLE ... DROP DETACHED PART\[ITION] ... 语句
## allow\_dynamic\_type\_in\_join\_keys
允许在 JOIN 连接键中使用 Dynamic 类型。此设置是为兼容性而添加的。不建议在 JOIN 连接键中使用 Dynamic 类型，因为与其他类型比较时可能会产生意外结果。
## allow\_execute\_multiif\_columnar
允许以列式方式执行 multiIf 函数
## allow\_fuzz\_query\_functions
启用 `fuzzQuery` 函数，该函数会对查询字符串进行随机 AST 变更。
## allow\_general\_join\_planning
允许使用一种更通用的 JOIN 规划算法，可处理更复杂的条件，但仅适用于 hash join。如果未启用 hash join，则无论此设置的值如何，都会使用常规的 JOIN 规划算法。
允许使用函数 `getClientHTTPHeader`，该函数可用于获取当前 HTTP 请求的请求头值。出于安全考虑，此功能默认未启用，因为某些请求头 (如 `Cookie`) 可能包含敏感信息。请注意，`X-ClickHouse-*`、`Authentication` 和 `Authorization` 请求头始终受限，无法通过此函数获取。
## allow\_hyperscan
允许使用 Hyperscan 库的函数。禁用此设置可避免潜在的编译时间过长以及资源占用过高。
## allow\_iceberg\_remove\_orphan\_files
允许对 Iceberg 表执行 'ALTER TABLE ... EXECUTE remove\_orphan\_files()'。
## allow\_insert\_into\_iceberg
**别名**: `allow_experimental_insert_into_iceberg`
允许执行向 Iceberg 插入数据的 `insert` 查询。
## allow\_introspection\_functions
启用或禁用用于查询性能分析的[内部信息函数](/zh/reference/functions/regular-functions/introspection)。
可选值：
* 1 — 启用内部信息函数。
* 0 — 禁用内部信息函数。
**另请参阅**
* [采样查询分析器](/zh/concepts/features/performance/troubleshoot/sampling-query-profiler)
* 系统表 [trace\_log](/zh/reference/system-tables/trace_log)
## allow\_key\_condition\_coalesce\_rewrite
const` 的谓词（以及等价的 `ifNull` 形式，或常量在左侧的情况）重写为析取形式，从而可以使用每个 `a_i` 上的按列主键和跳过索引。还支持部分常量形式，例如 `coalesce(a, 42, b)` 和 `coalesce(a, b, 42)`。"}]}]} />
在索引分析之前，将形如 `coalesce(a_1, ..., a_N) const` 的谓词 (以及等价的 `ifNull` 形式，或常量在左侧的情况) 重写为析取形式 `(a_1 const) OR (a_1 IS NULL AND a_2 const) OR ... OR (a_1 IS NULL AND ... AND a_{N-1} IS NULL AND a_N const)`，从而可以使用每个 `a_i` 上的按列主键和跳过索引。支持部分常量形式，例如 `coalesce(a, 42, b)` 和 `coalesce(a, b, 42)`：参数列表会像 `coalesce` 本身一样进行归一化 (丢弃 `NULL` 字面量，以及第一个非 `Nullable` 参数之后的参数) ；如果末尾存在非 `NULL` 常量，则会将其作为最终分支输出。此重写仅用于增强索引裁剪；运行时过滤仍使用原始谓词。
此外，形如 `nullIf(key, sentinel) = const` 的精确相等谓词 (其中 `sentinel != const` 且类型完全匹配) 会被重写为 `key = const`，以便 `key` 上的主键、分区和跳过索引可以直接裁剪粒度。不支持对范围条件和析取式 nullIf 进行裁剪。
## allow\_limit\_by\_partitions\_independently
当分区表达式是 `LIMIT BY` 列的确定性函数时，启用在独立线程中按分区分别计算 `LIMIT BY`。
## allow\_lossy\_numeric\_supertype
启用后，`if`/`multiIf`/`coalesce`/`ifNull`/`array`/`map` 在处理一组不存在无损公共类型的数值参数时 (例如 `Decimal` 与 `Float64`，或 `Int64` 与 `Float64`) ，会将其解析为数值超类型 (`Float64`) ，而非报错，但可能损失精度。这样，结果便可直接用于 `sum`、`avg`、`min` 和 `max` 等合并值的聚合函数。此设置独立于 `use_variant_as_common_type`：无论是否启用 `use_variant_as_common_type`，都会生成数值超类型。禁用时 (默认) ，此类参数集没有公共类型，因此若启用了 `use_variant_as_common_type`，会成为 `Variant`；否则会引发 `NO_COMMON_TYPE`。
## allow\_materialized\_view\_with\_bad\_select
允许 CREATE MATERIALIZED VIEW 使用引用不存在表或列的 SELECT 查询。但该查询在语法上仍必须有效。不适用于 refreshable MV。如果 MV 的 schema 需要从 SELECT 查询中推断，也不适用 (即 CREATE 没有列列表，且没有 TO table) 。可用于在源表创建之前先创建 MV。
## allow\_metadata\_only\_named\_tuple\_alter
如果为 true，则对于仅添加新子字段的命名 Tuple，ALTER MODIFY COLUMN 操作仅修改元数据 (不会进行数据变更) 。
设为 false 可强制使用旧的完整变更行为。
## allow\_minmax\_index\_for\_json
允许在 JSON (Object) 列上创建 minmax 跳过索引。默认处于禁用状态，因为 minmax
索引的序列化过程无法处理 JSON 列中可能包含的不同类型的 Field 值。
## allow\_named\_collection\_override\_by\_default
默认允许覆盖命名集合中的字段。
## allow\_non\_metadata\_alters
允许执行不仅会影响表元数据，还会影响磁盘上数据的 alter 操作
## allow\_nonconst\_timezone\_arguments
允许在某些与时间相关的函数中使用非常量时区参数，例如 toTimeZone()、fromUnixTimestamp\*() 和 snowflakeIDToDateTime\*()。
此设置仅为兼容性而保留。在 ClickHouse 中，时区是数据类型的属性，也就是列的属性。
启用此设置会给人一种错误的印象，仿佛同一列中的不同值可以具有不同的时区。
因此，请不要启用此设置。
## allow\_nullable\_tuple\_in\_extracted\_subcolumns
控制类型为 `Tuple(...)` 的提取子列是否可以设为 `Nullable(Tuple(...))` 类型。
* `false`：返回 `Tuple(...)`，并对缺少该子列的行使用默认 Tuple 值。
* `true`：返回 `Nullable(Tuple(...))`，并对缺少该子列的行使用 `NULL`。
此设置仅控制提取子列的行为。
它不控制是否可以在表中创建 `Nullable(Tuple(...))` 列；这一点由 `enable_nullable_tuple_type` 控制。
ClickHouse 使用服务器启动时加载的此设置值。
通过 `SET` 或查询级 `SETTINGS` 所做的更改不会改变提取子列的行为。
要更改提取子列的行为，请在启动 profile 配置 (例如 users.xml) 中更新 `allow_nullable_tuple_in_extracted_subcolumns`，然后重启服务器。
## allow\_rank\_dense\_rank\_arguments
允许向 `RANK` 和 `DENSE_RANK` 窗口函数传递参数，以保持向后兼容。
根据 SQL 标准，`RANK` 和 `DENSE_RANK` 不接受任何参数——它们仅根据
`OVER (ORDER BY ...)` 窗口对行进行排名。在 26.5 之前的 ClickHouse 版本中，类似
`RANK(x) OVER (...)` 的查询会静默接受并忽略该参数，这会导致用户困惑
(显式写出的参数看起来似乎会影响排名，但实际上并不会) 。
当此设置为 `false` (默认值) 时，`RANK` 和 `DENSE_RANK` 会拒绝任何参数，并
抛出 `NUMBER_OF_ARGUMENTS_DOESNT_MATCH`。当设为 `true` 时，将恢复旧版的宽松行为——
参数会被静默忽略，与 26.5 之前的行为一致。
## allow\_reorder\_prewhere\_conditions
将条件从 WHERE 移至 PREWHERE 时，允许重新排序这些条件，以优化筛选
## allow\_replace\_partition\_from\_empty\_source
允许在源表对应分区中没有 parts 时，`ALTER TABLE ... REPLACE PARTITION ... FROM ...` 静默删除目标端分区。
默认情况下不允许这样做：如果源表在请求的分区中没有数据，那么从该源执行 `REPLACE PARTITION` 会抛出异常，因为这种情况下，该操作实际上等同于对目标端静默执行 `DROP PARTITION` (目标端数据会被删除，但不会有任何内容替换它) ，这也是意外数据丢失的常见原因 (参见 [#23727](https://github.com/ClickHouse/ClickHouse/issues/23727)) 。
启用此设置可恢复之前的行为，例如当你有意使用空源分区来清空目标端数据时。若要无条件删除，建议直接改用 `ALTER TABLE ... DROP PARTITION ...`。
## allow\_settings\_after\_format\_in\_insert
控制是否允许在 `INSERT` 查询中于 `FORMAT` 之后使用 `SETTINGS`。不建议使用此设置，因为这可能会将 `SETTINGS` 的一部分解释为值。
示例：
```sql theme={null}
INSERT INTO FUNCTION null('foo String') SETTINGS max_threads=1 VALUES ('bar');
```
但以下查询只有在启用 `allow_settings_after_format_in_insert` 时才能运行：
```sql theme={null}
SET allow_settings_after_format_in_insert=1;
INSERT INTO FUNCTION null('foo String') VALUES ('bar') SETTINGS max_threads=1;
```
可能的值：
* 0 — 禁止。
* 1 — 允许。
仅当你的用例依赖旧语法、需要保持向后兼容时，才使用此设置。
## allow\_simdjson
如果支持 AVX2 指令，则允许在 `JSON*` 函数中使用 simdjson 库。禁用后将使用 rapidjson。
## allow\_special\_serialization\_kinds\_in\_output\_formats
允许直接输出具有 Sparse 和 Replicated 等特殊序列化类型的列，而无需将其转换为普通列表示。
这有助于避免格式化过程中不必要的数据复制。
## allow\_unrestricted\_reads\_from\_keeper
允许从 system.zookeeper 表进行不受限制的读取 (即不对 path 作条件限制) 。这可能会比较方便，但对 ZooKeeper 来说并不安全