Перейти к основному содержимому
Перейти к основному содержимому

Бета и экспериментальные функции

Поскольку ClickHouse является проектом с открытым исходным кодом, он получает много вкладов не только от сотрудников ClickHouse, но и от сообщества. Эти вклады часто разрабатываются с различной скоростью; определенные функции могут требовать более длительной фазы прототипирования или больше времени для получения достаточной обратной связи от сообщества и итераций, чтобы считаться общедоступными (GA).

В связи с неопределенностью, когда функции классифицируются как общедоступные, мы разделяем функции на две категории: Beta и Experimental.

Beta функции официально поддерживаются командой ClickHouse. Experimental функции являются ранними прототипами, разработанными либо командой ClickHouse, либо сообществом и не находятся под официальной поддержкой.

Ниже в разделах подробно описаны свойства Beta и Experimental функций:

Beta функции

  • Находятся на активной разработке для их общего доступного состояния (GA)
  • Основные известные проблемы можно отслеживать на GitHub
  • Функциональность может измениться в будущем
  • Возможна активация в ClickHouse Cloud
  • Команда ClickHouse поддерживает beta функции

Ниже представлены функции, считающиеся Beta в ClickHouse Cloud и доступные для использования в ваших сервисах ClickHouse Cloud.

Примечание: убедитесь, что вы используете актуальную версию настройки ClickHouse совместимости, чтобы использовать недавно введенную функцию.

Experimental функции

  • Никогда не могут стать GA
  • Могут быть удалены
  • Могут вводить разрушающие изменения
  • Функциональность может измениться в будущем
  • Необходимо намеренно включить
  • Команда ClickHouse не поддерживает экспериментальные функции
  • Может отсутствовать важная функциональность и документация
  • Не может быть включен в облаке

Обратите внимание: в ClickHouse Cloud не разрешено включать дополнительные экспериментальные функции, кроме перечисленных выше как Beta.

Beta настройки

НазваниеЗначение по умолчанию
geotoh3_argument_orderlat_lon
enable_lightweight_update1
allow_experimental_correlated_subqueries1
allow_experimental_parallel_reading_from_replicas0
parallel_replicas_moderead_tasks
parallel_replicas_count0
parallel_replica_offset0
parallel_replicas_custom_key``
parallel_replicas_custom_key_range_lower0
parallel_replicas_custom_key_range_upper0
cluster_for_parallel_replicas``
parallel_replicas_allow_in_with_subquery1
parallel_replicas_for_non_replicated_merge_tree0
parallel_replicas_min_number_of_rows_per_replica0
parallel_replicas_prefer_local_join1
parallel_replicas_mark_segment_size0
parallel_replicas_local_plan1
parallel_replicas_index_analysis_only_on_coordinator1
parallel_replicas_support_projection1
parallel_replicas_only_with_analyzer1
parallel_replicas_insert_select_local_pipeline1
parallel_replicas_connect_timeout_ms300
allow_experimental_database_iceberg0
allow_experimental_database_unity_catalog0
allow_experimental_database_glue_catalog0
session_timezone``
low_priority_query_wait_time_ms1000
allow_experimental_delta_kernel_rs1

Experimental настройки

НазваниеЗначение по умолчанию
allow_experimental_replacing_merge_with_cleanup0
allow_experimental_reverse_key0
allow_remote_fs_zero_copy_replication0
enable_replacing_merge_with_cleanup_for_min_age_to_force_merge0
force_read_through_cache_for_merges0
merge_selector_algorithmSimple
notify_newest_block_number0
part_moves_between_shards_delay_seconds30
part_moves_between_shards_enable0
remote_fs_zero_copy_path_compatible_mode0
remote_fs_zero_copy_zookeeper_path/clickhouse/zero_copy
remove_rolled_back_parts_immediately1
shared_merge_tree_activate_coordinated_merges_tasks0
shared_merge_tree_enable_coordinated_merges0
shared_merge_tree_enable_keeper_parts_extra_data0
shared_merge_tree_merge_coordinator_election_check_period_ms30000
shared_merge_tree_merge_coordinator_factor1.1
shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms10000
shared_merge_tree_merge_coordinator_max_merge_request_size20
shared_merge_tree_merge_coordinator_max_period_ms10000
shared_merge_tree_merge_coordinator_merges_prepare_count100
shared_merge_tree_merge_coordinator_min_period_ms1
shared_merge_tree_merge_worker_fast_timeout_ms100
shared_merge_tree_merge_worker_regular_timeout_ms10000
shared_merge_tree_virtual_parts_discovery_batch1
allow_experimental_time_time64_type0
allow_experimental_kafka_offsets_storage_in_keeper0
allow_experimental_delta_lake_writes0
allow_experimental_materialized_postgresql_table0
allow_experimental_funnel_functions0
allow_experimental_nlp_functions0
allow_experimental_hash_functions0
allow_experimental_object_type0
allow_experimental_time_series_table0
allow_experimental_codecs0
throw_on_unsupported_query_inside_transaction1
wait_changes_become_visible_after_commit_modewait_unknown
implicit_transaction0
grace_hash_join_initial_buckets1
grace_hash_join_max_buckets1024
join_to_sort_minimum_perkey_rows40
join_to_sort_maximum_table_rows10000
allow_experimental_join_right_table_sorting0
allow_statistics_optimize0
allow_experimental_statistics0
allow_experimental_full_text_index0
allow_experimental_live_view0
live_view_heartbeat_interval15
max_live_view_insert_blocks_before_refresh64
allow_experimental_window_view0
window_view_clean_interval60
window_view_heartbeat_interval15
wait_for_window_view_fire_signal_timeout10
stop_refreshable_materialized_views_on_startup0
allow_experimental_database_materialized_postgresql0
allow_experimental_qbit_type0
allow_experimental_query_deduplication0
allow_experimental_database_hms_catalog0
allow_experimental_kusto_dialect0
allow_experimental_prql_dialect0
enable_adaptive_memory_spill_scheduler0
allow_experimental_insert_into_iceberg0
allow_experimental_iceberg_compaction0
write_full_path_in_iceberg_metadata0
iceberg_metadata_compression_method``
make_distributed_plan0
distributed_plan_execute_locally0
distributed_plan_default_shuffle_join_bucket_count8
distributed_plan_default_reader_bucket_count8
distributed_plan_force_exchange_kind``
distributed_plan_max_rows_to_broadcast20000
allow_experimental_ytsaurus_table_engine0
allow_experimental_ytsaurus_table_function0
allow_experimental_ytsaurus_dictionary_source0
distributed_plan_force_shuffle_aggregation0
enable_join_runtime_filters0
join_runtime_bloom_filter_bytes524288
join_runtime_bloom_filter_hash_functions3
rewrite_in_to_join0
allow_experimental_time_series_aggregate_functions0
promql_database``
promql_table``
promql_evaluation_timeauto