ベータ機能と実験的機能

ClickHouse はオープンソースであるため、ClickHouse の社員だけでなく、コミュニティからも多くのコントリビューションが寄せられます。これらのコントリビューションはさまざまな速度で開発が進むことが多く、一部の機能は、一般提供 (GA) と見なされるまでに、長期のプロトタイピング段階や、コミュニティからの十分なフィードバックと改善のための時間を要する場合があります。機能がいつ一般提供として分類されるかは一律ではないため、機能を ベータ、実験的、プライベートプレビュー の 3 つのカテゴリに分けています。 ベータ 機能は ClickHouse チームによって公式にサポートされています。実験的 機能は、ClickHouse チームまたはコミュニティ主導で開発されている初期段階のプロトタイプであり、公式にはサポートされていません。プライベートプレビュー 機能は一般提供に向けた明確な道筋がある一方で、適用範囲がまだ限定的であり、本番環境での利用は推奨されません。以下のセクションでは、ベータ 機能、実験的 機能、プライベートプレビュー 機能の特性を明確に説明します。

ベータ機能

一般提供 (GA) に向けて現在も活発に開発が進められています
主な既知の問題は GitHub で追跡できます
今後、機能が変更される可能性があります
ClickHouse Cloud で有効になる場合があります
ClickHouse チームはベータ機能をサポートしています

以下に、ClickHouse Cloud でベータと見なされ、ClickHouse Cloud サービスで利用可能な機能を示します。注: 最近導入された機能を利用するには、ClickHouse の compatibility 設定で最新バージョンを使用していることを必ず確認してください。

実験的機能

GA になるとは限りません
削除される可能性があります
互換性を損なう変更が入る可能性があります
機能の動作が変更される可能性があります
明示的に有効化する必要があります
ClickHouse チームは実験的機能をサポートしていません
重要な機能やドキュメントが不足している場合があります
Cloud では有効化できません

ご注意ください: 上記でベータとして記載されているものを除き、ClickHouse Cloud では追加の実験的機能は有効化できません。

プライベートプレビュー機能

一般提供 (GA) に向けた明確な道筋があります
適用範囲はまだ限定的です
本番環境での利用は推奨されません
今後、機能の動作が変更される可能性があります
明示的に有効化する必要があります

ベータ設定

設定名	デフォルト
compute_exact_num_defaults_for_sparse_columns	`1`
packed_skip_index_max_bytes	`1048576`
framing_output_format	`None`
enable_join_transitive_predicates	`1`
geotoh3_argument_order	`lat_lon`
optimize_trivial_count_with_sparsity_filter	`1`
enable_lightweight_update	`1`
allow_correlated_subqueries	`1`
allow_delta_lake_writes	`0`
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`
parallel_replicas_filter_pushdown	`0`
parallel_replicas_allow_view_over_mergetree	`0`
allow_database_iceberg	`0`
allow_database_unity_catalog	`0`
allow_database_glue_catalog	`0`
session_timezone	“
low_priority_query_wait_time_ms	`1000`
enable_json_lazy_type_hints	`0`
ai_function_request_timeout_sec	`60`
ai_function_max_retries	`1`
ai_function_retry_initial_delay_ms	`1000`
ai_function_throw_on_error	`1`
ai_function_max_input_tokens_per_query	`1000000`
ai_function_max_output_tokens_per_query	`500000`
ai_function_max_api_calls_per_query	`1000`
ai_function_throw_on_quota_exceeded	`1`
ai_function_embedding_max_batch_size	`100`
ai_function_text_default_credentials	“
ai_function_embedding_default_credentials	“
ai_function_allow_insecure_endpoint	`0`
enable_alp_codec	`0`
allow_delta_kernel_rs	`1`
allow_insert_into_iceberg	`0`
cascades_aggregation_pushdown	`1`

実験的な設定

設定名	デフォルト値
allow_commit_order_projection	`0`
allow_experimental_replacing_merge_with_cleanup	`0`
allow_experimental_text_index_phrase_search	`0`
allow_remote_fs_zero_copy_replication	`0`
distributed_index_analysis_min_indexes_bytes_to_activate	`1073741824`
distributed_index_analysis_min_parts_to_activate	`10`
enable_adaptive_codec_selection	`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_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`
use_reader_executor	`0`
reader_executor_use_long_connections	`0`
reader_executor_min_bytes_for_seek	`2097152`
reader_executor_max_tail_for_drain	`1048576`
reader_executor_window_size	`8388608`
reader_executor_block_size	`1048576`
group_by_top_k_optimization_observation_rows	`65536`
query_plan_optimize_join_order_max_searched_plans	`100000`
query_plan_optimize_join_order_randomize	`0`
ast_fuzzer_runs	`0`
ast_fuzzer_any_query	`0`
ast_fuzzer_oracle	`0`
allow_fuzz_query_functions	`0`
reserve_memory	`0`
resumable_backup_from_snapshot	`0`
allow_url_wildcard_from_index_pages	`0`
enable_materialized_cte	`0`
analyzer_inline_views	`0`
allow_kafka_offsets_storage_in_keeper	`0`
automatic_parallel_replicas_mode	`0`
automatic_parallel_replicas_min_bytes_per_replica	`1048576`
parallel_replicas_plan_based	`0`
parallel_replicas_allow_merge_tables	`0`
distributed_index_analysis	`0`
enable_materialized_postgresql_table	`0`
enable_funnel_functions	`0`
allow_experimental_nlp_functions	`0`
allow_experimental_hash_functions	`0`
unique_key_max_encoded_size	`256`
unique_key_probe_implementation	`auto`
enable_unique_key	`0`
enable_quantized_codec	`0`
enable_sz3_codec	`0`
enable_zxc_codec	`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_join_right_table_sorting	`0`
enable_streaming_queries	`0`
stop_refreshable_materialized_views_on_startup	`0`
allow_experimental_database_materialized_postgresql	`0`
allow_experimental_database_hms_catalog	`0`
allow_experimental_kusto_dialect	`0`
allow_experimental_prql_dialect	`0`
allow_experimental_polyglot_dialect	`0`
enable_json_ast_dialect	`0`
polyglot_dialect	“
enable_trino_dialect	`0`
enable_adaptive_memory_spill_scheduler	`0`
allow_delta_lake_create_table	`0`
allow_experimental_cleanup_old_data_files_compaction	`0`
allow_experimental_iceberg_compaction	`0`
iceberg_manifest_min_count_to_compact	`100`
allow_iceberg_remove_orphan_files	`0`
iceberg_orphan_files_older_than_seconds	`259200`
allow_experimental_expire_snapshots	`0`
write_full_path_in_iceberg_metadata	`0`
iceberg_metadata_compression_method	“
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`
distributed_plan_read_in_order	`0`
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_cascades_optimizer	`0`
rewrite_in_to_join	`0`
allow_experimental_paimon_storage_engine	`0`
paimon_target_snapshot_id	`-1`
max_consume_snapshots	`0`
use_paimon_partition_pruning	`0`
allow_experimental_object_storage_queue_hive_partitioning	`0`
query_plan_optimize_join_order_algorithm	`greedy`
query_plan_optimize_join_order_conflict_detector	“
allow_experimental_database_paimon_rest_catalog	`0`
webassembly_udf_max_fuel	`100000`
webassembly_udf_max_memory	`134217728`
webassembly_udf_max_input_block_size	`0`
webassembly_udf_input_split_memory_ratio	`0.5`
webassembly_udf_max_instances	`32`
allow_experimental_eval_table_function	`0`

プライベートプレビューの設定

名前	デフォルト
enable_time_series_table	`0`
time_series_prefer_recent_samples_table	`1`
make_distributed_plan	`0`
distributed_plan_workers_num	`0`
distributed_plan_workers_provisioning_timeout_ms	`10000`
distributed_plan_prefer_replicas_over_workers	`0`
enable_time_series_aggregate_functions	`0`
promql_database	“
promql_table	“
promql_evaluation_time	`auto`

SQLリファレンス

データ型

エンジン

関数

フォーマット

設定

システムテーブル

データレイク