베타 및 실험적 기능 - ClickHouse Documentation

ClickHouse는 오픈소스이므로 ClickHouse 직원뿐 아니라 커뮤니티에서도 많은 기여가 이루어집니다. 이러한 기여는 개발 속도가 제각각인 경우가 많으며, 일부 기능은 일반 제공(GA)으로 간주되기까지 긴 프로토타이핑 단계가 필요하거나 충분한 커뮤니티 피드백과 반복 개선을 위해 더 많은 시간이 필요할 수 있습니다. 기능이 언제 일반 제공으로 분류될지 불확실할 수 있으므로, ClickHouse에서는 기능을 베타와 실험적의 두 가지 범주로 구분합니다. 베타 기능은 ClickHouse 팀이 공식적으로 지원합니다. 실험적 기능은 ClickHouse 팀 또는 커뮤니티가 주도하는 초기 프로토타입이며, 공식적으로 지원되지 않습니다. 아래 섹션에서는 베타 및 실험적 기능의 특성을 명확히 설명합니다.

베타 기능

일반 제공(GA)을 목표로 활발하게 개발 중입니다
알려진 주요 문제는 GitHub에서 추적할 수 있습니다
향후 동작이 변경될 수 있습니다
ClickHouse Cloud에서 활성화될 수 있습니다
ClickHouse 팀에서 베타 기능을 지원합니다

아래에서 ClickHouse Cloud에서 베타로 간주되며 ClickHouse Cloud 서비스에서 사용할 수 있는 기능을 확인할 수 있습니다. 참고: 최근 도입된 기능을 사용하려면 ClickHouse compatibility 설정의 최신 버전을 사용하고 있는지 확인하십시오.

실험적 기능

일반 제공(GA)되지 않을 수 있습니다
제거될 수 있습니다
호환성이 깨지는 변경이 발생할 수 있습니다
기능의 동작이 변경될 수 있습니다
명시적으로 활성화해야 합니다
ClickHouse 팀은 실험적 기능을 지원하지 않습니다
중요한 기능과 문서가 부족할 수 있습니다
ClickHouse Cloud에서는 활성화할 수 없습니다

참고: 위에 베타로 나열된 항목 외의 추가 실험적 기능은 ClickHouse Cloud에서 활성화할 수 없습니다.

베타 설정

이름	기본값
enable_join_transitive_predicates	`1`
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`
parallel_replicas_filter_pushdown	`0`
parallel_replicas_allow_view_over_mergetree	`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`
allow_experimental_nullable_tuple_type	`0`
allow_experimental_delta_kernel_rs	`1`
allow_insert_into_iceberg	`0`
enable_join_runtime_filters	`1`

실험적 기능 설정

이름	기본값
allow_commit_order_projection	`0`
allow_experimental_replacing_merge_with_cleanup	`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_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`
packed_skip_index_max_bytes	`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`
use_reader_executor	`0`
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`
allow_fuzz_query_functions	`0`
enable_materialized_cte	`0`
analyzer_inline_views	`0`
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	`1048576`
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`
unique_key_max_encoded_size	`256`
allow_experimental_unique_key	`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_json_lazy_type_hints	`0`
enable_streaming_queries	`0`
allow_experimental_text_index_lazy_apply	`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`
allow_experimental_polyglot_dialect	`0`
polyglot_dialect	“
enable_adaptive_memory_spill_scheduler	`0`
allow_experimental_cleanup_old_data_files_compaction	`0`
allow_experimental_iceberg_compaction	`0`
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	“
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`
distributed_plan_prefer_replicas_over_workers	`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`
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_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`
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_max_instances	`32`
allow_experimental_ai_functions	`0`
ai_function_credentials	“
ai_function_request_timeout_sec	`60`
ai_function_max_retries	`0`
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	`0`
ai_function_throw_on_quota_exceeded	`1`
ai_function_embedding_max_batch_size	`100`

​베타 기능

​실험적 기능

​베타 설정

​실험적 기능 설정

베타 기능

실험적 기능

베타 설정

실험적 기능 설정