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

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

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

Из-за неопределённости момента, когда возможности переходят в статус общедоступных, мы делим их на две категории: Бета и Экспериментальные.

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

В разделах ниже подробно описываются свойства Бета- и Экспериментальных функций:

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

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

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

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

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

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

Обратите внимание: в 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
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_statistics_optimize1
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
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
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_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