Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

allow_experimental_* session settings

These settings are available in system.settings and are autogenerated from source.

allow_experimental_analyzer

Aliases: enable_analyzer

Type
Bool
Default
1
Version history
VersionDefault valueComment
24.31Enable analyzer and planner by default.

Allow the analyzer.

allow_experimental_cleanup_old_data_files_compaction

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.50New setting

Allow to clean up old data files during Iceberg compaction.

allow_experimental_correlated_subqueries

Beta feature
Type
Bool
Default
1
Version history
VersionDefault valueComment
25.81Mark correlated subqueries support as Beta.
25.40Added new setting to allow correlated subqueries execution.

Allow to execute correlated subqueries.

allow_experimental_database_glue_catalog

Beta feature

Aliases: allow_database_glue_catalog

Type
Bool
Default
0
Version history
VersionDefault valueComment
25.30Allow 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
25.50Allow experimental database engine DataLakeCatalog with catalog_type = 'hive'

Allow experimental database engine DataLakeCatalog with catalog_type = ‘hms’

allow_experimental_database_iceberg

Beta feature

Aliases: allow_database_iceberg

Type
Bool
Default
0
Version history
VersionDefault valueComment
24.120New setting.

Allow experimental database engine DataLakeCatalog with catalog_type = ‘iceberg’

Cloud default value: 1.

allow_experimental_database_materialized_postgresql

Experimental feature
Type
Bool
Default
0

Allow to create database with Engine=MaterializedPostgreSQL(…).

allow_experimental_database_paimon_rest_catalog

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.10New setting

Allow experimental database engine DataLakeCatalog with catalog_type = ‘paimon_rest’

allow_experimental_database_unity_catalog

Beta feature

Aliases: allow_database_unity_catalog

Type
Bool
Default
0
Version history
VersionDefault valueComment
25.30Allow 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 feature

Aliases: allow_delta_lake_writes

Type
Bool
Default
0
Version history
VersionDefault valueComment
26.70Delta Lake writes were moved to Beta.
25.90New setting.

Enables delta-kernel writes feature.

allow_experimental_eval_table_function

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.70New setting to enable the experimental table function `eval`.

Enable experimental table function eval.

allow_experimental_expire_snapshots

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.30New setting.

Allow to execute experimental Iceberg command ALTER TABLE ... EXECUTE expire_snapshots.

allow_experimental_funnel_functions

Experimental feature
Type
Bool
Default
0

Enable experimental functions for funnel analysis.

allow_experimental_geo_types_in_iceberg

Type
Bool
Default
0
Version history
VersionDefault valueComment
26.50New 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 feature
Type
Bool
Default
0

Enable experimental hash functions

allow_experimental_iceberg_compaction

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
25.80New setting

Allow to explicitly use ‘OPTIMIZE’ for iceberg tables.

allow_experimental_join_right_table_sorting

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
24.90If 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.30New 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
24.80Allow 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
25.10A new setting

Enable the Kusto Query Language (KQL) dialect - an alternative to SQL.

allow_experimental_materialized_postgresql_table

Experimental feature
Type
Bool
Default
0

Allows to use the MaterializedPostgreSQL table engine. Disabled by default, because this feature is experimental

allow_experimental_nlp_functions

Experimental feature
Type
Bool
Default
0

Enable experimental functions for natural language processing.

allow_experimental_nullable_tuple_type

Beta feature

Aliases: enable_nullable_tuple_type

Type
Bool
Default
0
Version history
VersionDefault valueComment
26.10New 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.10New setting.

Allow to use hive partitioning with S3Queue/AzureQueue engines

allow_experimental_paimon_storage_engine

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.50New setting.

Allow to create tables with Paimon* table engines.

allow_experimental_parallel_reading_from_replicas

Aliases: enable_parallel_replicas

Type
UInt64
Default
0

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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.30New 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
25.10A new setting

Enable PRQL - an alternative to SQL.

allow_experimental_time_series_aggregate_functions

Experimental feature

Aliases: allow_experimental_ts_to_grid_aggregate_function

Type
Bool
Default
0
Version history
VersionDefault valueComment
25.60New 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
24.80Added new setting to allow the TimeSeries table engine

Allows creation of tables with the TimeSeries table engine. Possible values:

allow_experimental_unique_key

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.50New 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
26.70New 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 feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
25.80New setting.

Experimental dictionary source for integration with YTsaurus.

allow_experimental_ytsaurus_table_engine

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
25.80New setting.

Experimental table engine for integration with YTsaurus.

allow_experimental_ytsaurus_table_function

Experimental feature
Type
Bool
Default
0
Version history
VersionDefault valueComment
25.80New setting.

Experimental table engine for integration with YTsaurus.

Navigation