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

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

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

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

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

Ниже приведены разделы, которые подробно описывают свойства бета-функций и экспериментальных функций:

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

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

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

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

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

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

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

Настройки в бета-версии

ИмяПо умолчанию
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
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

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

NameDefault
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_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_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
use_statistics_cache0
allow_experimental_full_text_index0
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_filter_exact_values_limit10000
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
allow_experimental_alias_table_engine0
use_paimon_partition_pruning0