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

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

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

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

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

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

Бета-функции

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

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

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

Экспериментальные возможности

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

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

Бета-настройки

ИмяЗначение по умолчанию
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
geotoh3_argument_orderlat_lon
enable_lightweight_update1
allow_experimental_correlated_subqueries1
parallel_replicas_count0
parallel_replica_offset0
parallel_replicas_custom_key``
parallel_replicas_custom_key_range_lower0
parallel_replicas_custom_key_range_upper0
allow_experimental_database_iceberg0
allow_experimental_database_unity_catalog0
allow_experimental_database_glue_catalog0
session_timezone``
low_priority_query_wait_time_ms1000
enable_qbit_type1
allow_statistics_optimize1
use_statistics1
enable_full_text_index0
allow_experimental_delta_kernel_rs1

Экспериментальные настройки

НазваниеЗначение по умолчанию
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
merge_selector_enable_heuristic_to_lower_max_parts_to_merge_at_once0
merge_selector_heuristic_to_lower_max_parts_to_merge_at_once_exponent5
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_virtual_parts_discovery_batch1
allow_experimental_kafka_offsets_storage_in_keeper0
allow_experimental_delta_lake_writes0
automatic_parallel_replicas_mode0
automatic_parallel_replicas_min_bytes_per_replica0
distributed_index_analysis0
allow_experimental_materialized_postgresql_table0
allow_experimental_funnel_functions0
allow_experimental_nlp_functions0
allow_experimental_hash_functions0
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_experimental_statistics0
use_statistics_cache0
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_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_filter_exact_values_limit10000
join_runtime_bloom_filter_bytes524288
join_runtime_bloom_filter_hash_functions3
join_runtime_filter_pass_ratio_threshold_for_disabling0.7
join_runtime_filter_blocks_to_skip_before_reenabling30
join_runtime_bloom_filter_max_ratio_of_set_bits0.7
rewrite_in_to_join0
allow_experimental_time_series_aggregate_functions0
promql_database``
promql_table``
promql_evaluation_timeauto
allow_experimental_alias_table_engine0
use_paimon_partition_pruning0
allow_experimental_object_storage_queue_hive_partitioning0
query_plan_optimize_join_order_algorithmgreedy
allow_experimental_database_paimon_rest_catalog0