ベータ機能および実験的機能

ClickHouse はオープンソースであるため、ClickHouse の従業員だけでなくコミュニティからも多くのコントリビューションを受けています。これらのコントリビューションは必ずしも同じスピードで開発されるわけではなく、一部の機能については、一般提供 (GA) と見なされるまでに長い試作段階が必要になったり、コミュニティから十分なフィードバックと反復を得るために時間を要する場合があります。

機能が一般提供として分類されるタイミングには不確実性があるため、機能を ベータ (Beta) と 実験的 (Experimental) の 2 つのカテゴリーに区分しています。

ベータ (Beta) 機能は、ClickHouse チームによって正式にサポートされます。実験的 (Experimental) 機能は、ClickHouse チームまたはコミュニティによって主導される初期段階のプロトタイプであり、正式にはサポートされていません。

以下のセクションでは、ベータ (Beta) 機能および 実験的 (Experimental) 機能の特性について明確に説明します。

ベータ機能

• 一般提供（GA）を目指して積極的に開発中
• 主な既知の問題はGitHubで追跡可能
• 機能は将来変更される可能性があります
• ClickHouse Cloudで有効化されている場合があります
• ClickHouseチームがベータ機能をサポートしています

以下は、ClickHouse Cloudでベータ版と位置付けられており、ClickHouse Cloudサービスで利用可能な機能です。

注：最近導入された機能を使用するには、ClickHouseの互換性設定で最新バージョンを使用していることを確認してください。

実験的機能

• GA（一般提供）に移行しない可能性があります
• 削除される可能性があります
• 破壊的変更を導入する可能性があります
• 機能の動作が変更される可能性があります
• 明示的に有効化する必要があります
• ClickHouseチームは実験的機能をサポートしていません
• 重要な機能やドキュメントが欠けている可能性があります
• クラウド環境では有効化できません

注意：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
allow_experimental_parallel_reading_from_replicas	0
parallel_replicas_mode	read_tasks
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
cluster_for_parallel_replicas	``
parallel_replicas_allow_in_with_subquery	1
parallel_replicas_for_non_replicated_merge_tree	0
parallel_replicas_min_number_of_rows_per_replica	0
parallel_replicas_prefer_local_join	1
parallel_replicas_mark_segment_size	0
parallel_replicas_local_plan	1
parallel_replicas_index_analysis_only_on_coordinator	1
parallel_replicas_support_projection	1
parallel_replicas_only_with_analyzer	1
parallel_replicas_insert_select_local_pipeline	1
parallel_replicas_connect_timeout_ms	300
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
allow_experimental_delta_kernel_rs	1

実験的設定

Name	Default
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
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_time_time64_type	0
allow_experimental_kafka_offsets_storage_in_keeper	0
allow_experimental_delta_lake_writes	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_statistics_optimize	0
allow_experimental_statistics	0
use_statistics_cache	0
allow_experimental_full_text_index	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_qbit_type	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
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