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

ClickHouse はオープンソースであるため、ClickHouse の従業員だけでなくコミュニティからも多くの貢献を受けています。これらの貢献はそれぞれ異なるペースで開発されることが多く、ある機能は、一般提供 (GA) とみなされるまでに、長期にわたるプロトタイピング段階や、十分なコミュニティからのフィードバック収集と反復のための時間を必要とする場合があります。

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

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

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

ベータ機能

• 一般提供 (GA) に向けて積極的に開発中
• 主な既知の問題は GitHub で追跡可能
• 今後、機能が変更される可能性あり
• ClickHouse Cloud で有効化されている場合がある
• ClickHouse チームによるサポート対象

以下は、ClickHouse Cloud においてベータと見なされており、お客様の ClickHouse Cloud サービスで利用可能な機能です。

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

実験的機能

• GA にならない可能性があります
• 削除される可能性があります
• 破壊的な変更が導入される可能性があります
• 機能が今後変更される可能性があります
• 明示的に有効化する必要があります
• ClickHouse チームは実験的機能をサポートしません
• 重要な機能やドキュメントが不足している場合があります
• 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