Beta 和实验性功能

由于 ClickHouse 是开源的，它不仅接受来自 ClickHouse 员工的贡献，也接受来自社区的贡献。这些贡献的开发节奏往往不同；某些功能可能需要较长时间的原型设计阶段，或者需要更多时间来收集足够的社区反馈并进行迭代，才能被视为一般可用（GA）。

鉴于将功能归类为一般可用的时间存在不确定性，我们将功能划分为两类：Beta 和 Experimental。

Beta 功能由 ClickHouse 团队正式支持。Experimental 功能是由 ClickHouse 团队或社区推动的早期原型，并未获得正式支持。

下文各节将明确定义 Beta 和 Experimental 功能的特性：

测试版特性

• 正在积极开发中，目标是实现全面可用（GA）
• 主要已知问题可以在 GitHub 上进行跟踪
• 功能在未来可能会发生变化
• 可能在 ClickHouse Cloud 中已启用
• ClickHouse 团队为测试版特性提供支持

以下是当前在 ClickHouse Cloud 中被视为测试版、并可在你的 ClickHouse Cloud 服务中使用的特性。

注意：请确保你正在使用当前版本的 ClickHouse compatibility 设置，以便使用最近引入的特性。

实验性特性

• 可能永远不会进入 GA
• 可能会被移除
• 可能引入破坏性变更
• 该特性的功能可能会发生变化
• 需要被显式启用
• ClickHouse 团队不支持实验性特性
• 可能缺少重要功能和文档
• 无法在 Cloud 中启用

请注意：除上述列为 Beta 的特性外，不允许在 ClickHouse Cloud 中启用任何额外的实验性特性。

测试版设置

名称	默认值
shared_merge_tree_activate_coordinated_merges_tasks	0
shared_merge_tree_enable_coordinated_merges	0
shared_merge_tree_enable_keeper_parts_extra_data	0
shared_merge_tree_merge_coordinator_election_check_period_ms	30000
shared_merge_tree_merge_coordinator_factor	1.1
shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms	10000
shared_merge_tree_merge_coordinator_max_merge_request_size	20
shared_merge_tree_merge_coordinator_max_period_ms	10000
shared_merge_tree_merge_coordinator_merges_prepare_count	100
shared_merge_tree_merge_coordinator_min_period_ms	1
shared_merge_tree_merge_worker_fast_timeout_ms	100
shared_merge_tree_merge_worker_regular_timeout_ms	10000
geotoh3_argument_order	lat_lon
enable_lightweight_update	1
allow_experimental_correlated_subqueries	1
parallel_replicas_count	0
parallel_replica_offset	0
parallel_replicas_custom_key	``
parallel_replicas_custom_key_range_lower	0
parallel_replicas_custom_key_range_upper	0
allow_experimental_database_iceberg	0
allow_experimental_database_unity_catalog	0
allow_experimental_database_glue_catalog	0
session_timezone	``
low_priority_query_wait_time_ms	1000
enable_qbit_type	1
allow_statistics_optimize	1
use_statistics	1
enable_full_text_index	0
allow_experimental_delta_kernel_rs	1

实验性设置

名称	默认值
allow_experimental_replacing_merge_with_cleanup	0
allow_experimental_reverse_key	0
allow_remote_fs_zero_copy_replication	0
enable_replacing_merge_with_cleanup_for_min_age_to_force_merge	0
force_read_through_cache_for_merges	0
merge_selector_algorithm	Simple
merge_selector_enable_heuristic_to_lower_max_parts_to_merge_at_once	0
merge_selector_heuristic_to_lower_max_parts_to_merge_at_once_exponent	5
notify_newest_block_number	0
part_moves_between_shards_delay_seconds	30
part_moves_between_shards_enable	0
remote_fs_zero_copy_path_compatible_mode	0
remote_fs_zero_copy_zookeeper_path	/clickhouse/zero_copy
remove_rolled_back_parts_immediately	1
shared_merge_tree_virtual_parts_discovery_batch	1
allow_experimental_kafka_offsets_storage_in_keeper	0
allow_experimental_delta_lake_writes	0
automatic_parallel_replicas_mode	0
automatic_parallel_replicas_min_bytes_per_replica	0
distributed_index_analysis	0
allow_experimental_materialized_postgresql_table	0
allow_experimental_funnel_functions	0
allow_experimental_nlp_functions	0
allow_experimental_hash_functions	0
allow_experimental_time_series_table	0
allow_experimental_codecs	0
throw_on_unsupported_query_inside_transaction	1
wait_changes_become_visible_after_commit_mode	wait_unknown
implicit_transaction	0
grace_hash_join_initial_buckets	1
grace_hash_join_max_buckets	1024
join_to_sort_minimum_perkey_rows	40
join_to_sort_maximum_table_rows	10000
allow_experimental_join_right_table_sorting	0
allow_experimental_statistics	0
use_statistics_cache	0
allow_experimental_window_view	0
window_view_clean_interval	60
window_view_heartbeat_interval	15
wait_for_window_view_fire_signal_timeout	10
stop_refreshable_materialized_views_on_startup	0
allow_experimental_database_materialized_postgresql	0
allow_experimental_query_deduplication	0
allow_experimental_database_hms_catalog	0
allow_experimental_kusto_dialect	0
allow_experimental_prql_dialect	0
enable_adaptive_memory_spill_scheduler	0
allow_experimental_insert_into_iceberg	0
allow_experimental_iceberg_compaction	0
write_full_path_in_iceberg_metadata	0
iceberg_metadata_compression_method	``
make_distributed_plan	0
distributed_plan_execute_locally	0
distributed_plan_default_shuffle_join_bucket_count	8
distributed_plan_default_reader_bucket_count	8
distributed_plan_force_exchange_kind	``
distributed_plan_max_rows_to_broadcast	20000
allow_experimental_ytsaurus_table_engine	0
allow_experimental_ytsaurus_table_function	0
allow_experimental_ytsaurus_dictionary_source	0
distributed_plan_force_shuffle_aggregation	0
enable_join_runtime_filters	0
join_runtime_filter_exact_values_limit	10000
join_runtime_bloom_filter_bytes	524288
join_runtime_bloom_filter_hash_functions	3
join_runtime_filter_pass_ratio_threshold_for_disabling	0.7
join_runtime_filter_blocks_to_skip_before_reenabling	30
join_runtime_bloom_filter_max_ratio_of_set_bits	0.7
rewrite_in_to_join	0
allow_experimental_time_series_aggregate_functions	0
promql_database	``
promql_table	``
promql_evaluation_time	auto
allow_experimental_alias_table_engine	0
use_paimon_partition_pruning	0
allow_experimental_object_storage_queue_hive_partitioning	0
query_plan_optimize_join_order_algorithm	greedy
allow_experimental_database_paimon_rest_catalog	0