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

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
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_statistics_optimize	1
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	シンプル
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
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_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