这些设置可在 system.settings 中查看,由 源代码 自动生成。
allow_experimental_ai_functions
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.4 | 0 | 新增设置 |
启用实验性 AI 函数 (例如 aiGenerateContent) 。这些函数会向 AI 提供商发起外部 HTTP 调用。
allow_experimental_analyzer
别名: enable_analyzer
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.3 | 1 | 默认启用 analyzer 和 planner。 |
允许启用 analyzer。
allow_experimental_cleanup_old_data_files_compaction
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.5 | 0 | 新设置 |
允许在 Iceberg 合并整理期间清理旧数据文件。
allow_experimental_codecs
如果将其设置为 true,则允许指定任何 Experimental 压缩编解码器。
Beta 版功能版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.8 | 1 | 将对关联子查询的支持标记为 Beta。 |
| 25.4 | 0 | 新增设置,允许执行关联子查询。 |
允许执行关联子查询。
allow_experimental_database_glue_catalog
别名: allow_database_glue_catalog
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.3 | 0 | 启用 catalog_type = 'glue' 的 Experimental 数据库引擎 DataLakeCatalog |
启用 catalog_type = 'glue' 的 Experimental 数据库引擎 DataLakeCatalog
Cloud 默认值:1。
allow_experimental_database_hms_catalog
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.5 | 0 | 允许使用 catalog_type = 'hive' 的Experimental数据库引擎 DataLakeCatalog |
允许使用 catalog_type = 'hms' 的Experimental数据库引擎 DataLakeCatalog
allow_experimental_database_iceberg
别名: allow_database_iceberg
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.12 | 0 | 新设置。 |
允许使用 catalog_type = 'iceberg' 的Experimental DataLakeCatalog 数据库引擎
Cloud 默认值:1。
allow_experimental_database_materialized_postgresql
允许创建使用 Engine=MaterializedPostgreSQL(…) 的 database。
allow_experimental_database_paimon_rest_catalog
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.1 | 0 | 新设置 |
允许使用 catalog_type = 'paimon_rest' 的Experimental数据库引擎 DataLakeCatalog
allow_experimental_database_unity_catalog
别名: allow_database_unity_catalog
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.3 | 0 | 允许使用 catalog_type = 'unity' 的Experimental数据库引擎 DataLakeCatalog |
允许使用 catalog_type = 'unity' 的Experimental数据库引擎 DataLakeCatalog
Cloud 默认值:1。
allow_experimental_delta_lake_writes
别名: allow_delta_lake_writes
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.7 | 0 | Delta Lake 写入功能已调整为 Beta。 |
| 25.9 | 0 | 新设置。 |
启用 delta-kernel 写入功能。
allow_experimental_eval_table_function
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.7 | 0 | 新增设置,用于启用 Experimental 表函数 `eval`。 |
启用 Experimental 表函数 eval。
allow_experimental_expire_snapshots
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.3 | 0 | 新增设置。 |
允许执行Experimental的 Iceberg 命令 ALTER TABLE ... EXECUTE expire_snapshots。
allow_experimental_funnel_functions
启用用于漏斗分析的 Experimental 函数。
allow_experimental_geo_types_in_iceberg
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.5 | 0 | 新增设置,允许将 Iceberg 的 geometry/geography 字段解析为 Geometry 类型。 |
允许将 Iceberg geometry 和 geography 字段类型解析为 ClickHouse Geometry (Variant) 类型。
allow_experimental_hash_functions
启用Experimental哈希函数
allow_experimental_iceberg_compaction
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.8 | 0 | 新设置 |
允许显式地对 Iceberg 表执行 'OPTIMIZE'。
allow_experimental_join_right_table_sorting
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.9 | 0 | 如果将其设置为 true,且满足 `join_to_sort_minimum_perkey_rows` 和 `join_to_sort_maximum_table_rows` 的条件,则会按键对右表重新排序,以提升 left 或 inner hash join 的性能 |
如果将其设置为 true,且满足 join_to_sort_minimum_perkey_rows 和 join_to_sort_maximum_table_rows 的条件,则会按键对右表重新排序,以提升 left 或 inner hash join 的性能。
allow_experimental_json_lazy_type_hints
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.3 | 0 | 惰性 JSON 类型提示的新增Experimental设置 |
为 JSON 类型启用Experimental的惰性类型提示。此功能可通过延迟类型提示求值来优化 JSON 类型转换。
allow_experimental_kafka_offsets_storage_in_keeper
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.8 | 0 | 允许使用将已提交偏移量存储在 ClickHouse Keeper 中的 Experimental Kafka 存储引擎 |
允许使用一项 Experimental 功能,将 Kafka 相关偏移量存储在 ClickHouse Keeper 中。启用后,可以为 Kafka 表引擎指定 ClickHouse Keeper 路径和副本名称。这样一来,系统将不再使用常规的 Kafka 引擎,而会改用一种新的存储引擎类型,优先将已提交的偏移量存储在 ClickHouse Keeper 中
allow_experimental_kusto_dialect
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.1 | 0 | 一项新设置 |
启用 Kusto 查询语言 (KQL),可作为 SQL 的替代方案。
allow_experimental_materialized_postgresql_table
允许使用 MaterializedPostgreSQL 表引擎。默认处于禁用状态,因为该功能仍处于 Experimental 阶段
allow_experimental_nlp_functions
启用 Experimental 自然语言处理函数。
allow_experimental_nullable_tuple_type
别名: enable_nullable_tuple_type
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.1 | 0 | 新的 Experimental 设置 |
此设置不控制提取出的 Tuple 子列是否可以为 Nullable (例如,从 Dynamic、Variant、JSON 或 Tuple 列中提取出的子列) 。
请使用 allow_nullable_tuple_in_extracted_subcolumns 来控制提取出的 Tuple 子列是否可以为 Nullable。
allow_experimental_object_storage_queue_hive_partitioning
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.1 | 0 | 新设置。 |
允许在 S3Queue/AzureQueue 引擎中使用 Hive 分区
allow_experimental_paimon_storage_engine
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.5 | 0 | New setting. |
允许创建使用 Paimon* 表引擎的表。
allow_experimental_parallel_reading_from_replicas
别名: enable_parallel_replicas
对每个分片,SELECT 查询执行时最多可使用 max_parallel_replicas 个副本。读取会并行执行,并进行动态协调。0 - 禁用,1 - 启用,失败时静默禁用,2 - 启用,失败时抛出异常
allow_experimental_polyglot_dialect
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.3 | 0 | 新增设置,用于启用 polyglot SQL 转译器方言。 |
启用 polyglot SQL 转译器:可将 30 多种 SQL 方言 (MySQL、PostgreSQL、SQLite、Snowflake、DuckDB 等) 转译为 ClickHouse SQL。
allow_experimental_prql_dialect
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.1 | 0 | 新设置 |
启用 PRQL——作为 SQL 的一种替代方案。
allow_experimental_time_series_aggregate_functions
别名: allow_experimental_ts_to_grid_aggregate_function
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.6 | 0 | 用于启用Experimental timeSeries* 聚合函数的新设置。 |
用于进行类似 Prometheus 的时间序列重采样、rate 和 delta 计算的Experimental timeSeries* 聚合函数。
allow_experimental_time_series_table
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 24.8 | 0 | 新增设置,允许使用 TimeSeries 表引擎 |
允许创建使用 TimeSeries 表引擎的表。可选值:
- 0 — TimeSeries 表引擎已禁用。
- 1 — TimeSeries 表引擎已启用。
allow_experimental_unique_key
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.5 | 0 | 用于控制是否在 MergeTree 家族表上启用实验性 `UNIQUE KEY` 子句的新设置 |
允许在 MergeTree 家族引擎上使用 UNIQUE KEY 子句创建表。
allow_experimental_url_wildcard_from_index_pages
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 26.7 | 0 | 新增设置:通过列出 HTTP 索引页,为 `url` 表函数启用通配符展开。 |
允许 url() 和 ENGINE = URL 通过 HTTP 索引页进行 Experimental 通配符展开。
allow_experimental_window_view
启用 WINDOW VIEW。该功能尚不成熟。
allow_experimental_ytsaurus_dictionary_source
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.8 | 0 | 新增设置。 |
用于与 YTsaurus 集成的 Experimental 字典源。
allow_experimental_ytsaurus_table_engine
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.8 | 0 | 新设置。 |
用于集成 YTsaurus 的 Experimental 表引擎。
allow_experimental_ytsaurus_table_function
版本历史
| 版本 | 默认值 | 注释 |
|---|---|---|
| 25.8 | 0 | 新设置。 |
用于与 YTsaurus 集成的 Experimental 表引擎。