These settings are available in system.settings and are autogenerated from source.
allow_experimental_analyzer
Aliases: enable_analyzer
Version history
| Version | Default value | Comment |
|---|---|---|
| 24.3 | 1 | Enable analyzer and planner by default. |
Allow the analyzer.
allow_experimental_cleanup_old_data_files_compaction
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.5 | 0 | New setting |
Allow to clean up old data files during Iceberg compaction.
allow_experimental_correlated_subqueries
Beta featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 25.8 | 1 | Mark correlated subqueries support as Beta. |
| 25.4 | 0 | Added new setting to allow correlated subqueries execution. |
Allow to execute correlated subqueries.
allow_experimental_database_glue_catalog
Beta featureAliases: allow_database_glue_catalog
Version history
| Version | Default value | Comment |
|---|---|---|
| 25.3 | 0 | Allow experimental database engine DataLakeCatalog with catalog_type = 'glue' |
Allow experimental database engine DataLakeCatalog with catalog_type = ‘glue’
Cloud default value: 1.
allow_experimental_database_hms_catalog
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 25.5 | 0 | Allow experimental database engine DataLakeCatalog with catalog_type = 'hive' |
Allow experimental database engine DataLakeCatalog with catalog_type = ‘hms’
allow_experimental_database_iceberg
Beta featureAliases: allow_database_iceberg
Version history
| Version | Default value | Comment |
|---|---|---|
| 24.12 | 0 | New setting. |
Allow experimental database engine DataLakeCatalog with catalog_type = ‘iceberg’
Cloud default value: 1.
allow_experimental_database_materialized_postgresql
Experimental featureAllow to create database with Engine=MaterializedPostgreSQL(…).
allow_experimental_database_paimon_rest_catalog
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.1 | 0 | New setting |
Allow experimental database engine DataLakeCatalog with catalog_type = ‘paimon_rest’
allow_experimental_database_unity_catalog
Beta featureAliases: allow_database_unity_catalog
Version history
| Version | Default value | Comment |
|---|---|---|
| 25.3 | 0 | Allow experimental database engine DataLakeCatalog with catalog_type = 'unity' |
Allow experimental database engine DataLakeCatalog with catalog_type = ‘unity’
Cloud default value: 1.
allow_experimental_delta_lake_writes
Beta featureAliases: allow_delta_lake_writes
Version history
| Version | Default value | Comment |
|---|---|---|
| 26.7 | 0 | Delta Lake writes were moved to Beta. |
| 25.9 | 0 | New setting. |
Enables delta-kernel writes feature.
allow_experimental_eval_table_function
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.7 | 0 | New setting to enable the experimental table function `eval`. |
Enable experimental table function eval.
allow_experimental_expire_snapshots
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.3 | 0 | New setting. |
Allow to execute experimental Iceberg command ALTER TABLE ... EXECUTE expire_snapshots.
allow_experimental_funnel_functions
Experimental featureEnable experimental functions for funnel analysis.
allow_experimental_geo_types_in_iceberg
Version history
| Version | Default value | Comment |
|---|---|---|
| 26.5 | 0 | New setting to allow parsing Iceberg geometry/geography fields as Geometry type. |
Allow parsing Iceberg geometry and geography field types as ClickHouse Geometry (Variant) type.
allow_experimental_hash_functions
Experimental featureEnable experimental hash functions
allow_experimental_iceberg_compaction
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 25.8 | 0 | New setting |
Allow to explicitly use ‘OPTIMIZE’ for iceberg tables.
allow_experimental_join_right_table_sorting
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 24.9 | 0 | If it is set to true, and the conditions of `join_to_sort_minimum_perkey_rows` and `join_to_sort_maximum_table_rows` are met, rerange the right table by key to improve the performance in left or inner hash join |
If it is set to true, and the conditions of join_to_sort_minimum_perkey_rows and join_to_sort_maximum_table_rows are met, rerange the right table by key to improve the performance in left or inner hash join.
allow_experimental_json_lazy_type_hints
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.3 | 0 | New experimental setting for lazy JSON type hints |
Enable experimental lazy type hints for JSON type. This feature allows optimizing JSON type conversions by deferring type hint evaluation.
allow_experimental_kafka_offsets_storage_in_keeper
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 24.8 | 0 | Allow the usage of experimental Kafka storage engine that stores the committed offsets in ClickHouse Keeper |
Allow experimental feature to store Kafka related offsets in ClickHouse Keeper. When enabled a ClickHouse Keeper path and replica name can be specified to the Kafka table engine. As a result instead of the regular Kafka engine, a new type of storage engine will be used that stores the committed offsets primarily in ClickHouse Keeper
allow_experimental_kusto_dialect
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 25.1 | 0 | A new setting |
Enable the Kusto Query Language (KQL) dialect - an alternative to SQL.
allow_experimental_materialized_postgresql_table
Experimental featureAllows to use the MaterializedPostgreSQL table engine. Disabled by default, because this feature is experimental
allow_experimental_nlp_functions
Experimental featureEnable experimental functions for natural language processing.
allow_experimental_nullable_tuple_type
Beta featureAliases: enable_nullable_tuple_type
Version history
| Version | Default value | Comment |
|---|---|---|
| 26.1 | 0 | New experimental setting |
Allows creation of Nullable Tuple columns in tables.
This setting does not control whether extracted tuple subcolumns can be Nullable (for example, from Dynamic, Variant, JSON, or Tuple columns).
Use allow_nullable_tuple_in_extracted_subcolumns to control whether extracted tuple subcolumns can be Nullable.
allow_experimental_object_storage_queue_hive_partitioning
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.1 | 0 | New setting. |
Allow to use hive partitioning with S3Queue/AzureQueue engines
allow_experimental_paimon_storage_engine
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.5 | 0 | New setting. |
Allow to create tables with Paimon* table engines.
allow_experimental_parallel_reading_from_replicas
Aliases: enable_parallel_replicas
Use up to max_parallel_replicas the number of replicas from each shard for SELECT query execution. Reading is parallelized and coordinated dynamically. 0 - disabled, 1 - enabled, silently disable them in case of failure, 2 - enabled, throw an exception in case of failure
allow_experimental_polyglot_dialect
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.3 | 0 | New setting to enable the polyglot SQL transpiler dialect. |
Enable polyglot SQL transpiler - transpiles SQL from 30+ dialects (MySQL, PostgreSQL, SQLite, Snowflake, DuckDB, etc.) into ClickHouse SQL.
allow_experimental_prql_dialect
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 25.1 | 0 | A new setting |
Enable PRQL - an alternative to SQL.
allow_experimental_time_series_aggregate_functions
Experimental featureAliases: allow_experimental_ts_to_grid_aggregate_function
Version history
| Version | Default value | Comment |
|---|---|---|
| 25.6 | 0 | New setting to enable experimental timeSeries* aggregate functions. |
Experimental timeSeries* aggregate functions for Prometheus-like timeseries resampling, rate, delta calculation.
allow_experimental_time_series_table
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 24.8 | 0 | Added new setting to allow the TimeSeries table engine |
Allows creation of tables with the TimeSeries table engine. Possible values:
- 0 — the TimeSeries table engine is disabled.
- 1 — the TimeSeries table engine is enabled.
allow_experimental_unique_key
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.5 | 0 | New setting to gate the experimental UNIQUE KEY clause on MergeTree-family tables |
Allows creation of tables with the UNIQUE KEY clause on MergeTree-family engines.
allow_experimental_url_wildcard_from_index_pages
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 26.7 | 0 | New setting to enable expanding wildcards in the `url` table function by listing HTTP index pages. |
Allow experimental wildcard expansion for url() and ENGINE = URL from HTTP index pages.
allow_experimental_ytsaurus_dictionary_source
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 25.8 | 0 | New setting. |
Experimental dictionary source for integration with YTsaurus.
allow_experimental_ytsaurus_table_engine
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 25.8 | 0 | New setting. |
Experimental table engine for integration with YTsaurus.
allow_experimental_ytsaurus_table_function
Experimental featureVersion history
| Version | Default value | Comment |
|---|---|---|
| 25.8 | 0 | New setting. |
Experimental table engine for integration with YTsaurus.