> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# allow_experimental_* 세션 설정

> allow_experimental_*로 생성된 그룹에 속한 ClickHouse 세션 설정입니다.

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>유형</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>기본값</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          재시작 없이 변경 가능
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>베타</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                베타 기능. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        자세히 보기.
                    </a>
                </u>
            </span>
        </div>;
};

export const ExperimentalBadge = () => {
  return <div className="experimentalBadge">
            <div className="experimentalIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.25" d="M5.5 2H10.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M9.50015 2V6.19625L13.4283 12.7425C13.4738 12.8183 13.4985 12.9049 13.4996 12.9934C13.5008 13.0818 13.4785 13.169 13.435 13.246C13.3914 13.323 13.3283 13.3871 13.2519 13.4317C13.1755 13.4764 13.0886 13.4999 13.0002 13.5H3.00015C2.91164 13.5 2.8247 13.4766 2.74822 13.432C2.67174 13.3874 2.60847 13.3233 2.56487 13.2463C2.52126 13.1693 2.49889 13.082 2.50004 12.9935C2.50119 12.905 2.52582 12.8184 2.5714 12.7425L6.50015 6.19625V2" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M4.47656 9.56754C5.30344 9.41254 6.47656 9.47942 7.99969 10.25C10.0153 11.2707 11.4216 11.0569 12.2184 10.7282" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            실험 기능입니다. <u><a href="/docs/docs/beta-and-experimental-features#experimental-features">자세히 알아보세요.</a></u>
        </div>;
};

이러한 설정은 [system.settings](/docs/ko/reference/system-tables/settings)에서 확인할 수 있으며 [소스](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp)에서 자동 생성됩니다.

<div id="allow_experimental_ai_functions">
  ## allow\_experimental\_ai\_functions
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "0"},{"label": "새로운 설정"}]}]} />

실험적 AI 함수(예: `aiGenerateContent`)를 활성화합니다. 이 함수는 AI 프로바이더에 외부 HTTP 요청을 보냅니다.

<div id="allow_experimental_analyzer">
  ## allow\_experimental\_analyzer
</div>

**별칭**: `enable_analyzer`

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1"},{"label": "기본적으로 분석기와 플래너를 활성화합니다."}]}]} />

분석기 사용을 허용합니다.

<div id="allow_experimental_cleanup_old_data_files_compaction">
  ## allow\_experimental\_cleanup\_old\_data\_files\_compaction
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "새로운 설정"}]}]} />

Iceberg compaction 중 오래된 data files를 정리하도록 허용합니다.

<div id="allow_experimental_codecs">
  ## allow\_experimental\_codecs
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

true로 설정하면 실험적인 압축 코덱을 지정할 수 있습니다(하지만 현재는 해당 코덱이 없으므로 이 옵션은 아무런 효과가 없습니다).

<div id="allow_experimental_correlated_subqueries">
  ## allow\_experimental\_correlated\_subqueries
</div>

<BetaBadge />

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "1"},{"label": "상관 서브쿼리 지원을 베타로 지정했습니다."}]}, {"id": "row-2","items": [{"label": "25.4"},{"label": "0"},{"label": "상관 서브쿼리 실행을 허용하는 새로운 설정이 추가되었습니다."}]}]} />

상관 서브쿼리 실행을 허용합니다.

<div id="allow_experimental_database_glue_catalog">
  ## allow\_experimental\_database\_glue\_catalog
</div>

<BetaBadge />

**별칭**: `allow_database_glue_catalog`

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.3"},{"label": "0"},{"label": "catalog_type = 'glue'인 실험적 데이터베이스 엔진 DataLakeCatalog의 사용을 허용합니다"}]}]} />

catalog\_type = 'glue'인 실험적 데이터베이스 엔진 DataLakeCatalog의 사용을 허용합니다

Cloud 기본값: `1`.

<div id="allow_experimental_database_hms_catalog">
  ## allow\_experimental\_database\_hms\_catalog
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "0"},{"label": "catalog_type = 'hive'인 실험적 데이터베이스 엔진 DataLakeCatalog 사용 허용"}]}]} />

catalog\_type = 'hms'인 실험적 데이터베이스 엔진 DataLakeCatalog 사용 허용

<div id="allow_experimental_database_iceberg">
  ## allow\_experimental\_database\_iceberg
</div>

<BetaBadge />

**별칭**: `allow_database_iceberg`

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.12"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

catalog\_type = 'iceberg'인 실험적 데이터베이스 엔진 DataLakeCatalog 사용을 허용합니다.

Cloud 기본값: `1`.

<div id="allow_experimental_database_materialized_postgresql">
  ## allow\_experimental\_database\_materialized\_postgresql
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

Engine=MaterializedPostgreSQL(...)를 사용하는 데이터베이스 생성이 가능해집니다.

<div id="allow_experimental_database_paimon_rest_catalog">
  ## allow\_experimental\_database\_paimon\_rest\_catalog
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "0"},{"label": "새로운 설정"}]}]} />

`catalog_type = 'paimon_rest'`인 실험적 데이터베이스 엔진 DataLakeCatalog 사용을 허용합니다

<div id="allow_experimental_database_unity_catalog">
  ## allow\_experimental\_database\_unity\_catalog
</div>

<BetaBadge />

**별칭**: `allow_database_unity_catalog`

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.3"},{"label": "0"},{"label": "catalog_type = 'unity'인 실험적 데이터베이스 엔진 DataLakeCatalog를 허용합니다"}]}]} />

catalog\_type = 'unity'인 실험적 데이터베이스 엔진 DataLakeCatalog를 허용합니다

Cloud 기본값: `1`.

<div id="allow_experimental_delta_kernel_rs">
  ## allow\_experimental\_delta\_kernel\_rs
</div>

<BetaBadge />

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1"},{"label": "새로운 설정"}]}]} />

delta-kernel-rs의 실험적 구현을 허용합니다.

<div id="allow_experimental_delta_lake_writes">
  ## allow\_experimental\_delta\_lake\_writes
</div>

<BetaBadge />

**별칭**: `allow_delta_lake_writes`

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "Delta Lake 쓰기 기능이 베타로 전환되었습니다."}]}, {"id": "row-2","items": [{"label": "25.9"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

delta-kernel 쓰기 기능을 활성화합니다.

<div id="allow_experimental_eval_table_function">
  ## allow\_experimental\_eval\_table\_function
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "실험적 테이블 함수 `eval`을 활성화하기 위한 새로운 설정입니다."}]}]} />

실험적 테이블 함수 `eval`을 활성화합니다.

<div id="allow_experimental_expire_snapshots">
  ## allow\_experimental\_expire\_snapshots
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

실험적 Iceberg 명령 `ALTER TABLE ... EXECUTE expire_snapshots`을 실행할 수 있게 합니다.

<div id="allow_experimental_funnel_functions">
  ## allow\_experimental\_funnel\_functions
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

퍼널 분석용 실험적 함수를 활성화합니다.

<div id="allow_experimental_geo_types_in_iceberg">
  ## allow\_experimental\_geo\_types\_in\_iceberg
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "Iceberg geometry/geography 필드를 Geometry 타입으로 파싱할 수 있도록 허용하는 새로운 설정입니다."}]}]} />

Iceberg `geometry` 및 `geography` 필드 타입을 ClickHouse `Geometry` (Variant) 타입으로 파싱할 수 있도록 허용합니다.

<div id="allow_experimental_hash_functions">
  ## allow\_experimental\_hash\_functions
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

실험적 해시 함수를 활성화합니다.

<div id="allow_experimental_iceberg_compaction">
  ## allow\_experimental\_iceberg\_compaction
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "새로운 설정"}]}]} />

Iceberg 테이블에서 'OPTIMIZE'를 명시적으로 사용할 수 있도록 합니다.

<div id="allow_experimental_join_right_table_sorting">
  ## allow\_experimental\_join\_right\_table\_sorting
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.9"},{"label": "0"},{"label": "true로 설정되고 `join_to_sort_minimum_perkey_rows` 및 `join_to_sort_maximum_table_rows`의 조건이 충족되면, left 또는 inner 해시 조인의 성능 향상을 위해 오른쪽 테이블을 키 기준으로 재정렬합니다"}]}]} />

true로 설정되고 `join_to_sort_minimum_perkey_rows` 및 `join_to_sort_maximum_table_rows`의 조건이 충족되면, left 또는 inner 해시 조인의 성능 향상을 위해 오른쪽 테이블을 키 기준으로 재정렬합니다.

<div id="allow_experimental_json_lazy_type_hints">
  ## allow\_experimental\_json\_lazy\_type\_hints
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "0"},{"label": "JSON 타입의 지연 실행 타입 힌트를 위한 새로운 실험적 설정"}]}]} />

JSON 타입의 실험적 지연 실행 타입 힌트를 활성화합니다. 이 기능을 사용하면 타입 힌트 평가를 지연시켜 JSON 타입 변환을 최적화할 수 있습니다.

<div id="allow_experimental_kafka_offsets_storage_in_keeper">
  ## allow\_experimental\_kafka\_offsets\_storage\_in\_keeper
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.8"},{"label": "0"},{"label": "커밋된 오프셋을 ClickHouse Keeper에 저장하는 실험적 Kafka 저장 엔진의 사용을 허용합니다"}]}]} />

Kafka 관련 오프셋을 ClickHouse Keeper에 저장하는 실험적 기능을 허용합니다. 이 기능을 활성화하면 ClickHouse Keeper 경로와 레플리카 이름을 Kafka 테이블 엔진에 지정할 수 있습니다. 그러면 일반적인 Kafka 엔진 대신, 커밋된 오프셋을 주로 ClickHouse Keeper에 저장하는 새로운 유형의 저장 엔진이 사용됩니다.

<div id="allow_experimental_kusto_dialect">
  ## allow\_experimental\_kusto\_dialect
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "새로운 설정"}]}]} />

SQL의 대안인 Kusto Query Language (KQL)를 활성화합니다.

<div id="allow_experimental_materialized_postgresql_table">
  ## allow\_experimental\_materialized\_postgresql\_table
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

MaterializedPostgreSQL 테이블 엔진을 사용할 수 있도록 허용합니다. 이 기능은 실험적 기능이므로 기본적으로 비활성화되어 있습니다.

<div id="allow_experimental_nlp_functions">
  ## allow\_experimental\_nlp\_functions
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

자연어 처리(NLP)를 위한 실험적 함수를 활성화합니다.

<div id="allow_experimental_nullable_tuple_type">
  ## allow\_experimental\_nullable\_tuple\_type
</div>

<BetaBadge />

**별칭**: `enable_nullable_tuple_type`

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "0"},{"label": "새 실험적 설정"}]}]} />

테이블에서 [널 허용](/docs/ko/reference/data-types/nullable) [Tuple](/docs/ko/reference/data-types/tuple) 컬럼을 생성할 수 있도록 허용합니다.

이 설정은 추출된 Tuple 서브컬럼을 `Nullable`로 만들 수 있는지는 제어하지 않습니다(예: Dynamic, Variant, JSON 또는 Tuple 컬럼에서 추출된 경우).
추출된 Tuple 서브컬럼을 `Nullable`로 만들 수 있는지 제어하려면 `allow_nullable_tuple_in_extracted_subcolumns`를 사용하십시오.

<div id="allow_experimental_object_storage_queue_hive_partitioning">
  ## allow\_experimental\_object\_storage\_queue\_hive\_partitioning
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

S3Queue/AzureQueue 엔진에서 Hive 파티셔닝 사용을 허용합니다

<div id="allow_experimental_paimon_storage_engine">
  ## allow\_experimental\_paimon\_storage\_engine
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

Paimon\* 테이블 엔진을 사용해 테이블을 생성할 수 있습니다.

<div id="allow_experimental_parallel_reading_from_replicas">
  ## allow\_experimental\_parallel\_reading\_from\_replicas
</div>

**별칭**: `enable_parallel_replicas`

<SettingsInfoBlock type="UInt64" default_value="0" />

각 세그먼트에서 SELECT 쿼리 실행 시 최대 `max_parallel_replicas`개의 레플리카를 사용합니다. 읽기는 병렬로 수행되며 동적으로 조정됩니다. 0 - 비활성화, 1 - 활성화, 실패 시 조용히 비활성화, 2 - 활성화, 실패 시 예외를 발생시킴

<div id="allow_experimental_polyglot_dialect">
  ## allow\_experimental\_polyglot\_dialect
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "0"},{"label": "polyglot SQL 트랜스파일러 방언을 활성화하는 새로운 설정입니다."}]}]} />

polyglot SQL 트랜스파일러를 활성화합니다. 이 기능은 30개 이상의 SQL 방언(MySQL, PostgreSQL, SQLite, Snowflake, DuckDB 등)을 ClickHouse SQL로 트랜스파일합니다.

<div id="allow_experimental_prql_dialect">
  ## allow\_experimental\_prql\_dialect
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "새로운 설정"}]}]} />

SQL의 대안인 PRQL을 활성화합니다.

<div id="allow_experimental_time_series_aggregate_functions">
  ## allow\_experimental\_time\_series\_aggregate\_functions
</div>

<ExperimentalBadge />

**별칭**: `allow_experimental_ts_to_grid_aggregate_function`

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "0"},{"label": "실험적 timeSeries* 집계 함수를 활성화하는 새로운 설정입니다."}]}]} />

Prometheus 스타일의 시계열 리샘플링, rate, delta 계산을 위한 실험적 timeSeries\* 집계 함수입니다.

<div id="allow_experimental_time_series_table">
  ## allow\_experimental\_time\_series\_table
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.8"},{"label": "0"},{"label": "TimeSeries 테이블 엔진을 허용하는 새로운 설정이 추가되었습니다"}]}]} />

[TimeSeries](/docs/ko/reference/engines/table-engines/integrations/time-series) 테이블 엔진으로 테이블을 생성할 수 있도록 합니다. 가능한 값은 다음과 같습니다.

* 0 — [TimeSeries](/docs/ko/reference/engines/table-engines/integrations/time-series) 테이블 엔진이 비활성화되어 있습니다.
* 1 — [TimeSeries](/docs/ko/reference/engines/table-engines/integrations/time-series) 테이블 엔진이 활성화되어 있습니다.

<div id="allow_experimental_unique_key">
  ## allow\_experimental\_unique\_key
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "0"},{"label": "MergeTree 계열 테이블에서 실험적 UNIQUE KEY 절 사용을 제어하는 새로운 설정"}]}]} />

MergeTree 계열 엔진에서 `UNIQUE KEY` 절을 사용하는 테이블 생성을 허용합니다.

<div id="allow_experimental_url_wildcard_from_index_pages">
  ## allow\_experimental\_url\_wildcard\_from\_index\_pages
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "0"},{"label": "HTTP 인덱스 페이지를 나열해 `url` 테이블 함수에서 와일드카드를 확장할 수 있게 하는 새로운 설정입니다."}]}]} />

HTTP 인덱스 페이지를 기반으로 `url()` 및 `ENGINE = URL`의 실험적 와일드카드 확장을 허용합니다.

<div id="allow_experimental_window_view">
  ## allow\_experimental\_window\_view
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

WINDOW VIEW를 활성화합니다. 아직 충분히 안정적이지 않습니다.

<div id="allow_experimental_ytsaurus_dictionary_source">
  ## allow\_experimental\_ytsaurus\_dictionary\_source
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

YTsaurus 통합용 실험적 딕셔너리 소스입니다.

<div id="allow_experimental_ytsaurus_table_engine">
  ## allow\_experimental\_ytsaurus\_table\_engine
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

YTsaurus 통합용 실험적 테이블 엔진입니다.

<div id="allow_experimental_ytsaurus_table_function">
  ## allow\_experimental\_ytsaurus\_table\_function
</div>

<ExperimentalBadge />

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

YTsaurus 통합을 위한 실험적 테이블 엔진입니다.