> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 베타 및 실험적 기능

> ClickHouse에는 베타 및 실험적 기능이 있습니다. 이 문서에서는 그 정의를 설명합니다.

ClickHouse는 오픈소스이므로 ClickHouse 직원뿐 아니라 커뮤니티에서도 많은 기여가 이루어집니다. 이러한 기여는 개발 속도가 제각각인 경우가 많으며, 일부 기능은 일반 제공(GA)으로 간주되기까지 긴 프로토타이핑 단계가 필요하거나 충분한 커뮤니티 피드백과 반복 개선을 위해 더 많은 시간이 필요할 수 있습니다.

기능이 언제 일반 제공으로 분류될지 불확실할 수 있으므로, ClickHouse에서는 기능을 **베타**와 **실험적**의 두 가지 범주로 구분합니다.

**베타** 기능은 ClickHouse 팀이 공식적으로 지원합니다. **실험적** 기능은 ClickHouse 팀 또는 커뮤니티가 주도하는 초기 프로토타입이며, 공식적으로 지원되지 않습니다.

아래 섹션에서는 **베타** 및 **실험적** 기능의 특성을 명확히 설명합니다.

<div id="beta-features">
  ## 베타 기능
</div>

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

아래에서 ClickHouse Cloud에서 베타로 간주되며 ClickHouse Cloud 서비스에서 사용할 수 있는 기능을 확인할 수 있습니다.

참고: 최근 도입된 기능을 사용하려면 ClickHouse [compatibility](/ko/reference/settings/session-settings#compatibility) 설정의 최신 버전을 사용하고 있는지 확인하십시오.

<div id="experimental-features">
  ## 실험적 기능
</div>

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

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

{/*AUTOGENERATED_START*/}

<div id="beta-settings">
  ## 베타 설정
</div>

| 이름                                                                                                                                      | 기본값       |
| --------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| [enable\_join\_transitive\_predicates](/ko/reference/settings/session-settings#enable_join_transitive_predicates)                       | `1`       |
| [geotoh3\_argument\_order](/ko/reference/settings/session-settings#geotoh3_argument_order)                                              | `lat_lon` |
| [enable\_lightweight\_update](/ko/reference/settings/session-settings#enable_lightweight_update)                                        | `1`       |
| [allow\_experimental\_correlated\_subqueries](/ko/reference/settings/session-settings#allow_experimental_correlated_subqueries)         | `1`       |
| [parallel\_replicas\_count](/ko/reference/settings/session-settings#parallel_replicas_count)                                            | `0`       |
| [parallel\_replica\_offset](/ko/reference/settings/session-settings#parallel_replica_offset)                                            | `0`       |
| [parallel\_replicas\_custom\_key](/ko/reference/settings/session-settings#parallel_replicas_custom_key)                                 | \`\`      |
| [parallel\_replicas\_custom\_key\_range\_lower](/ko/reference/settings/session-settings#parallel_replicas_custom_key_range_lower)       | `0`       |
| [parallel\_replicas\_custom\_key\_range\_upper](/ko/reference/settings/session-settings#parallel_replicas_custom_key_range_upper)       | `0`       |
| [parallel\_replicas\_filter\_pushdown](/ko/reference/settings/session-settings#parallel_replicas_filter_pushdown)                       | `0`       |
| [parallel\_replicas\_allow\_view\_over\_mergetree](/ko/reference/settings/session-settings#parallel_replicas_allow_view_over_mergetree) | `0`       |
| [allow\_experimental\_database\_iceberg](/ko/reference/settings/session-settings#allow_experimental_database_iceberg)                   | `0`       |
| [allow\_experimental\_database\_unity\_catalog](/ko/reference/settings/session-settings#allow_experimental_database_unity_catalog)      | `0`       |
| [allow\_experimental\_database\_glue\_catalog](/ko/reference/settings/session-settings#allow_experimental_database_glue_catalog)        | `0`       |
| [session\_timezone](/ko/reference/settings/session-settings#session_timezone)                                                           | \`\`      |
| [low\_priority\_query\_wait\_time\_ms](/ko/reference/settings/session-settings#low_priority_query_wait_time_ms)                         | `1000`    |
| [allow\_experimental\_nullable\_tuple\_type](/ko/reference/settings/session-settings#allow_experimental_nullable_tuple_type)            | `0`       |
| [allow\_experimental\_delta\_kernel\_rs](/ko/reference/settings/session-settings#allow_experimental_delta_kernel_rs)                    | `1`       |
| [allow\_insert\_into\_iceberg](/ko/reference/settings/session-settings#allow_insert_into_iceberg)                                       | `0`       |
| [enable\_join\_runtime\_filters](/ko/reference/settings/session-settings#enable_join_runtime_filters)                                   | `1`       |

<div id="experimental-settings">
  ## 실험적 기능 설정
</div>

| 이름                                                                                                                                                                                                   | 기본값                     |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| [allow\_commit\_order\_projection](/ko/reference/settings/merge-tree-settings#allow_commit_order_projection)                                                                                         | `0`                     |
| [allow\_experimental\_replacing\_merge\_with\_cleanup](/ko/reference/settings/merge-tree-settings#allow_experimental_replacing_merge_with_cleanup)                                                   | `0`                     |
| [allow\_remote\_fs\_zero\_copy\_replication](/ko/reference/settings/merge-tree-settings#allow_remote_fs_zero_copy_replication)                                                                       | `0`                     |
| [distributed\_index\_analysis\_min\_indexes\_bytes\_to\_activate](/ko/reference/settings/merge-tree-settings#distributed_index_analysis_min_indexes_bytes_to_activate)                               | `1073741824`            |
| [distributed\_index\_analysis\_min\_parts\_to\_activate](/ko/reference/settings/merge-tree-settings#distributed_index_analysis_min_parts_to_activate)                                                | `10`                    |
| [enable\_replacing\_merge\_with\_cleanup\_for\_min\_age\_to\_force\_merge](/ko/reference/settings/merge-tree-settings#enable_replacing_merge_with_cleanup_for_min_age_to_force_merge)                | `0`                     |
| [force\_read\_through\_cache\_for\_merges](/ko/reference/settings/merge-tree-settings#force_read_through_cache_for_merges)                                                                           | `0`                     |
| [merge\_selector\_algorithm](/ko/reference/settings/merge-tree-settings#merge_selector_algorithm)                                                                                                    | `Simple`                |
| [merge\_selector\_enable\_heuristic\_to\_lower\_max\_parts\_to\_merge\_at\_once](/ko/reference/settings/merge-tree-settings#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](/ko/reference/settings/merge-tree-settings#merge_selector_heuristic_to_lower_max_parts_to_merge_at_once_exponent) | `5`                     |
| [notify\_newest\_block\_number](/ko/reference/settings/merge-tree-settings#notify_newest_block_number)                                                                                               | `0`                     |
| [packed\_skip\_index\_max\_bytes](/ko/reference/settings/merge-tree-settings#packed_skip_index_max_bytes)                                                                                            | `0`                     |
| [part\_moves\_between\_shards\_delay\_seconds](/ko/reference/settings/merge-tree-settings#part_moves_between_shards_delay_seconds)                                                                   | `30`                    |
| [part\_moves\_between\_shards\_enable](/ko/reference/settings/merge-tree-settings#part_moves_between_shards_enable)                                                                                  | `0`                     |
| [remote\_fs\_zero\_copy\_path\_compatible\_mode](/ko/reference/settings/merge-tree-settings#remote_fs_zero_copy_path_compatible_mode)                                                                | `0`                     |
| [remote\_fs\_zero\_copy\_zookeeper\_path](/ko/reference/settings/merge-tree-settings#remote_fs_zero_copy_zookeeper_path)                                                                             | `/clickhouse/zero_copy` |
| [remove\_rolled\_back\_parts\_immediately](/ko/reference/settings/merge-tree-settings#remove_rolled_back_parts_immediately)                                                                          | `1`                     |
| [shared\_merge\_tree\_virtual\_parts\_discovery\_batch](/ko/reference/settings/merge-tree-settings#shared_merge_tree_virtual_parts_discovery_batch)                                                  | `1`                     |
| [use\_reader\_executor](/ko/reference/settings/session-settings#use_reader_executor)                                                                                                                 | `0`                     |
| [query\_plan\_optimize\_join\_order\_max\_searched\_plans](/ko/reference/settings/session-settings#query_plan_optimize_join_order_max_searched_plans)                                                | `100000`                |
| [query\_plan\_optimize\_join\_order\_randomize](/ko/reference/settings/session-settings#query_plan_optimize_join_order_randomize)                                                                    | `0`                     |
| [ast\_fuzzer\_runs](/ko/reference/settings/session-settings#ast_fuzzer_runs)                                                                                                                         | `0`                     |
| [ast\_fuzzer\_any\_query](/ko/reference/settings/session-settings#ast_fuzzer_any_query)                                                                                                              | `0`                     |
| [allow\_fuzz\_query\_functions](/ko/reference/settings/session-settings#allow_fuzz_query_functions)                                                                                                  | `0`                     |
| [enable\_materialized\_cte](/ko/reference/settings/session-settings#enable_materialized_cte)                                                                                                         | `0`                     |
| [analyzer\_inline\_views](/ko/reference/settings/session-settings#analyzer_inline_views)                                                                                                             | `0`                     |
| [allow\_experimental\_kafka\_offsets\_storage\_in\_keeper](/ko/reference/settings/session-settings#allow_experimental_kafka_offsets_storage_in_keeper)                                               | `0`                     |
| [allow\_experimental\_delta\_lake\_writes](/ko/reference/settings/session-settings#allow_experimental_delta_lake_writes)                                                                             | `0`                     |
| [automatic\_parallel\_replicas\_mode](/ko/reference/settings/session-settings#automatic_parallel_replicas_mode)                                                                                      | `0`                     |
| [automatic\_parallel\_replicas\_min\_bytes\_per\_replica](/ko/reference/settings/session-settings#automatic_parallel_replicas_min_bytes_per_replica)                                                 | `1048576`               |
| [distributed\_index\_analysis](/ko/reference/settings/session-settings#distributed_index_analysis)                                                                                                   | `0`                     |
| [allow\_experimental\_materialized\_postgresql\_table](/ko/reference/settings/session-settings#allow_experimental_materialized_postgresql_table)                                                     | `0`                     |
| [allow\_experimental\_funnel\_functions](/ko/reference/settings/session-settings#allow_experimental_funnel_functions)                                                                                | `0`                     |
| [allow\_experimental\_nlp\_functions](/ko/reference/settings/session-settings#allow_experimental_nlp_functions)                                                                                      | `0`                     |
| [allow\_experimental\_hash\_functions](/ko/reference/settings/session-settings#allow_experimental_hash_functions)                                                                                    | `0`                     |
| [allow\_experimental\_time\_series\_table](/ko/reference/settings/session-settings#allow_experimental_time_series_table)                                                                             | `0`                     |
| [unique\_key\_max\_encoded\_size](/ko/reference/settings/session-settings#unique_key_max_encoded_size)                                                                                               | `256`                   |
| [allow\_experimental\_unique\_key](/ko/reference/settings/session-settings#allow_experimental_unique_key)                                                                                            | `0`                     |
| [allow\_experimental\_codecs](/ko/reference/settings/session-settings#allow_experimental_codecs)                                                                                                     | `0`                     |
| [throw\_on\_unsupported\_query\_inside\_transaction](/ko/reference/settings/session-settings#throw_on_unsupported_query_inside_transaction)                                                          | `1`                     |
| [wait\_changes\_become\_visible\_after\_commit\_mode](/ko/reference/settings/session-settings#wait_changes_become_visible_after_commit_mode)                                                         | `wait_unknown`          |
| [implicit\_transaction](/ko/reference/settings/session-settings#implicit_transaction)                                                                                                                | `0`                     |
| [grace\_hash\_join\_initial\_buckets](/ko/reference/settings/session-settings#grace_hash_join_initial_buckets)                                                                                       | `1`                     |
| [grace\_hash\_join\_max\_buckets](/ko/reference/settings/session-settings#grace_hash_join_max_buckets)                                                                                               | `1024`                  |
| [join\_to\_sort\_minimum\_perkey\_rows](/ko/reference/settings/session-settings#join_to_sort_minimum_perkey_rows)                                                                                    | `40`                    |
| [join\_to\_sort\_maximum\_table\_rows](/ko/reference/settings/session-settings#join_to_sort_maximum_table_rows)                                                                                      | `10000`                 |
| [allow\_experimental\_join\_right\_table\_sorting](/ko/reference/settings/session-settings#allow_experimental_join_right_table_sorting)                                                              | `0`                     |
| [allow\_experimental\_json\_lazy\_type\_hints](/ko/reference/settings/session-settings#allow_experimental_json_lazy_type_hints)                                                                      | `0`                     |
| [enable\_streaming\_queries](/ko/reference/settings/session-settings#enable_streaming_queries)                                                                                                       | `0`                     |
| [allow\_experimental\_text\_index\_lazy\_apply](/ko/reference/settings/session-settings#allow_experimental_text_index_lazy_apply)                                                                    | `0`                     |
| [allow\_experimental\_window\_view](/ko/reference/settings/session-settings#allow_experimental_window_view)                                                                                          | `0`                     |
| [window\_view\_clean\_interval](/ko/reference/settings/session-settings#window_view_clean_interval)                                                                                                  | `60`                    |
| [window\_view\_heartbeat\_interval](/ko/reference/settings/session-settings#window_view_heartbeat_interval)                                                                                          | `15`                    |
| [wait\_for\_window\_view\_fire\_signal\_timeout](/ko/reference/settings/session-settings#wait_for_window_view_fire_signal_timeout)                                                                   | `10`                    |
| [stop\_refreshable\_materialized\_views\_on\_startup](/ko/reference/settings/session-settings#stop_refreshable_materialized_views_on_startup)                                                        | `0`                     |
| [allow\_experimental\_database\_materialized\_postgresql](/ko/reference/settings/session-settings#allow_experimental_database_materialized_postgresql)                                               | `0`                     |
| [allow\_experimental\_query\_deduplication](/ko/reference/settings/session-settings#allow_experimental_query_deduplication)                                                                          | `0`                     |
| [allow\_experimental\_database\_hms\_catalog](/ko/reference/settings/session-settings#allow_experimental_database_hms_catalog)                                                                       | `0`                     |
| [allow\_experimental\_kusto\_dialect](/ko/reference/settings/session-settings#allow_experimental_kusto_dialect)                                                                                      | `0`                     |
| [allow\_experimental\_prql\_dialect](/ko/reference/settings/session-settings#allow_experimental_prql_dialect)                                                                                        | `0`                     |
| [allow\_experimental\_polyglot\_dialect](/ko/reference/settings/session-settings#allow_experimental_polyglot_dialect)                                                                                | `0`                     |
| [polyglot\_dialect](/ko/reference/settings/session-settings#polyglot_dialect)                                                                                                                        | \`\`                    |
| [enable\_adaptive\_memory\_spill\_scheduler](/ko/reference/settings/session-settings#enable_adaptive_memory_spill_scheduler)                                                                         | `0`                     |
| [allow\_experimental\_cleanup\_old\_data\_files\_compaction](/ko/reference/settings/session-settings#allow_experimental_cleanup_old_data_files_compaction)                                           | `0`                     |
| [allow\_experimental\_iceberg\_compaction](/ko/reference/settings/session-settings#allow_experimental_iceberg_compaction)                                                                            | `0`                     |
| [allow\_iceberg\_remove\_orphan\_files](/ko/reference/settings/session-settings#allow_iceberg_remove_orphan_files)                                                                                   | `0`                     |
| [iceberg\_orphan\_files\_older\_than\_seconds](/ko/reference/settings/session-settings#iceberg_orphan_files_older_than_seconds)                                                                      | `259200`                |
| [allow\_experimental\_expire\_snapshots](/ko/reference/settings/session-settings#allow_experimental_expire_snapshots)                                                                                | `0`                     |
| [write\_full\_path\_in\_iceberg\_metadata](/ko/reference/settings/session-settings#write_full_path_in_iceberg_metadata)                                                                              | `0`                     |
| [iceberg\_metadata\_compression\_method](/ko/reference/settings/session-settings#iceberg_metadata_compression_method)                                                                                | \`\`                    |
| [make\_distributed\_plan](/ko/reference/settings/session-settings#make_distributed_plan)                                                                                                             | `0`                     |
| [distributed\_plan\_execute\_locally](/ko/reference/settings/session-settings#distributed_plan_execute_locally)                                                                                      | `0`                     |
| [distributed\_plan\_default\_shuffle\_join\_bucket\_count](/ko/reference/settings/session-settings#distributed_plan_default_shuffle_join_bucket_count)                                               | `8`                     |
| [distributed\_plan\_default\_reader\_bucket\_count](/ko/reference/settings/session-settings#distributed_plan_default_reader_bucket_count)                                                            | `8`                     |
| [distributed\_plan\_force\_exchange\_kind](/ko/reference/settings/session-settings#distributed_plan_force_exchange_kind)                                                                             | \`\`                    |
| [distributed\_plan\_max\_rows\_to\_broadcast](/ko/reference/settings/session-settings#distributed_plan_max_rows_to_broadcast)                                                                        | `20000`                 |
| [distributed\_plan\_prefer\_replicas\_over\_workers](/ko/reference/settings/session-settings#distributed_plan_prefer_replicas_over_workers)                                                          | `0`                     |
| [allow\_experimental\_ytsaurus\_table\_engine](/ko/reference/settings/session-settings#allow_experimental_ytsaurus_table_engine)                                                                     | `0`                     |
| [allow\_experimental\_ytsaurus\_table\_function](/ko/reference/settings/session-settings#allow_experimental_ytsaurus_table_function)                                                                 | `0`                     |
| [allow\_experimental\_ytsaurus\_dictionary\_source](/ko/reference/settings/session-settings#allow_experimental_ytsaurus_dictionary_source)                                                           | `0`                     |
| [distributed\_plan\_force\_shuffle\_aggregation](/ko/reference/settings/session-settings#distributed_plan_force_shuffle_aggregation)                                                                 | `0`                     |
| [join\_runtime\_filter\_exact\_values\_limit](/ko/reference/settings/session-settings#join_runtime_filter_exact_values_limit)                                                                        | `10000`                 |
| [join\_runtime\_bloom\_filter\_bytes](/ko/reference/settings/session-settings#join_runtime_bloom_filter_bytes)                                                                                       | `524288`                |
| [join\_runtime\_bloom\_filter\_hash\_functions](/ko/reference/settings/session-settings#join_runtime_bloom_filter_hash_functions)                                                                    | `3`                     |
| [join\_runtime\_filter\_pass\_ratio\_threshold\_for\_disabling](/ko/reference/settings/session-settings#join_runtime_filter_pass_ratio_threshold_for_disabling)                                      | `0.7`                   |
| [join\_runtime\_filter\_blocks\_to\_skip\_before\_reenabling](/ko/reference/settings/session-settings#join_runtime_filter_blocks_to_skip_before_reenabling)                                          | `30`                    |
| [join\_runtime\_bloom\_filter\_max\_ratio\_of\_set\_bits](/ko/reference/settings/session-settings#join_runtime_bloom_filter_max_ratio_of_set_bits)                                                   | `0.7`                   |
| [rewrite\_in\_to\_join](/ko/reference/settings/session-settings#rewrite_in_to_join)                                                                                                                  | `0`                     |
| [allow\_experimental\_time\_series\_aggregate\_functions](/ko/reference/settings/session-settings#allow_experimental_time_series_aggregate_functions)                                                | `0`                     |
| [promql\_database](/ko/reference/settings/session-settings#promql_database)                                                                                                                          | \`\`                    |
| [promql\_table](/ko/reference/settings/session-settings#promql_table)                                                                                                                                | \`\`                    |
| [promql\_evaluation\_time](/ko/reference/settings/session-settings#promql_evaluation_time)                                                                                                           | `auto`                  |
| [allow\_experimental\_paimon\_storage\_engine](/ko/reference/settings/session-settings)                                                                                                              | `0`                     |
| [paimon\_target\_snapshot\_id](/ko/reference/settings/session-settings)                                                                                                                              | `-1`                    |
| [max\_consume\_snapshots](/ko/reference/settings/session-settings)                                                                                                                                   | `0`                     |
| [use\_paimon\_partition\_pruning](/ko/reference/settings/session-settings#use_paimon_partition_pruning)                                                                                              | `0`                     |
| [allow\_experimental\_object\_storage\_queue\_hive\_partitioning](/ko/reference/settings/session-settings#allow_experimental_object_storage_queue_hive_partitioning)                                 | `0`                     |
| [query\_plan\_optimize\_join\_order\_algorithm](/ko/reference/settings/session-settings#query_plan_optimize_join_order_algorithm)                                                                    | `greedy`                |
| [allow\_experimental\_database\_paimon\_rest\_catalog](/ko/reference/settings/session-settings#allow_experimental_database_paimon_rest_catalog)                                                      | `0`                     |
| [webassembly\_udf\_max\_fuel](/ko/reference/settings/session-settings#webassembly_udf_max_fuel)                                                                                                      | `100000`                |
| [webassembly\_udf\_max\_memory](/ko/reference/settings/session-settings#webassembly_udf_max_memory)                                                                                                  | `134217728`             |
| [webassembly\_udf\_max\_input\_block\_size](/ko/reference/settings/session-settings#webassembly_udf_max_input_block_size)                                                                            | `0`                     |
| [webassembly\_udf\_max\_instances](/ko/reference/settings/session-settings#webassembly_udf_max_instances)                                                                                            | `32`                    |
| [allow\_experimental\_ai\_functions](/ko/reference/settings/session-settings#allow_experimental_ai_functions)                                                                                        | `0`                     |
| [ai\_function\_credentials](/ko/reference/settings/session-settings#ai_function_credentials)                                                                                                         | \`\`                    |
| [ai\_function\_request\_timeout\_sec](/ko/reference/settings/session-settings#ai_function_request_timeout_sec)                                                                                       | `60`                    |
| [ai\_function\_max\_retries](/ko/reference/settings/session-settings#ai_function_max_retries)                                                                                                        | `0`                     |
| [ai\_function\_retry\_initial\_delay\_ms](/ko/reference/settings/session-settings#ai_function_retry_initial_delay_ms)                                                                                | `1000`                  |
| [ai\_function\_throw\_on\_error](/ko/reference/settings/session-settings#ai_function_throw_on_error)                                                                                                 | `1`                     |
| [ai\_function\_max\_input\_tokens\_per\_query](/ko/reference/settings/session-settings#ai_function_max_input_tokens_per_query)                                                                       | `1000000`               |
| [ai\_function\_max\_output\_tokens\_per\_query](/ko/reference/settings/session-settings#ai_function_max_output_tokens_per_query)                                                                     | `500000`                |
| [ai\_function\_max\_api\_calls\_per\_query](/ko/reference/settings/session-settings#ai_function_max_api_calls_per_query)                                                                             | `0`                     |
| [ai\_function\_throw\_on\_quota\_exceeded](/ko/reference/settings/session-settings#ai_function_throw_on_quota_exceeded)                                                                              | `1`                     |
| [ai\_function\_embedding\_max\_batch\_size](/ko/reference/settings/session-settings#ai_function_embedding_max_batch_size)                                                                            | `100`                   |
