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

# allow_experimental_* 세션 설정

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

export const ExperimentalBadge = () => {
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#experimental-features" 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>
            실험 기능
        </a>;
};

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["버전", "기본값", "설명"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        버전 이력
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

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>;
};

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

## allow\_experimental\_analyzer

**별칭**: `enable_analyzer`

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.9"},{"label": "1"},{"label": "이 설정은 더 이상 사용되지 않습니다(obsolete): 분석기는 필수이며 이전 쿼리 분석은 더 이상 지원되지 않습니다. 비활성화 시도는 무시되지 않고 거부되며, 24.3 미만 버전으로 지정한 `compatibility` 설정으로도 되돌릴 수 없습니다."}]}, {"id": "row-2","items": [{"label": "24.3"},{"label": "1"},{"label": "분석기와 플래너를 기본적으로 활성화합니다."}]}]} />

v26.9부터 사용되지 않음(obsolete): 분석기는 더 이상 비활성화할 수 없습니다.

분석기는 v24.3부터 기본으로 사용되어 온 쿼리 분석 및 계획 수립 인프라입니다. v26.9에서 이 설정은 지원되는 유일한 값인 `1`로 고정되었습니다. `0`으로 설정하려는 시도는 거부되며, `compatibility` 설정으로도 되돌릴 수 없습니다. v26.10에서는 이 설정으로 전환하던 이전 쿼리 분석이 제거되었습니다. 쿼리, 세션 설정, 설정 프로필, 클라이언트 구성에서 `enable_analyzer = 0`을 제거하십시오. 이전 쿼리 분석과 쿼리의 동작이나 성능을 비교하려면 v26.9보다 이전 ClickHouse 버전을 사용하십시오.

## allow\_experimental\_cleanup\_old\_data\_files\_compaction

<ExperimentalBadge />

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

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

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

## allow\_experimental\_database\_hms\_catalog

<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 사용 허용

## allow\_experimental\_database\_materialized\_postgresql

<ExperimentalBadge />

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

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

## allow\_experimental\_database\_paimon\_rest\_catalog

<ExperimentalBadge />

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

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

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

## allow\_experimental\_eval\_table\_function

<ExperimentalBadge />

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

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

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

## allow\_experimental\_expire\_snapshots

<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`을 실행할 수 있게 합니다.

## allow\_experimental\_hash\_functions

<ExperimentalBadge />

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

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

## allow\_experimental\_iceberg\_compaction

<ExperimentalBadge />

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

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

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

## allow\_experimental\_kusto\_dialect

<ExperimentalBadge />

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

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

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

## allow\_experimental\_nlp\_functions

<ExperimentalBadge />

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

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

## allow\_experimental\_object\_storage\_queue\_hive\_partitioning

<ExperimentalBadge />

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

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

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

## allow\_experimental\_paimon\_storage\_engine

<ExperimentalBadge />

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

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

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

## allow\_experimental\_parallel\_reading\_from\_replicas

**별칭**: `enable_parallel_replicas`

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

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

## allow\_experimental\_polyglot\_dialect

<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로 트랜스파일합니다.

## allow\_experimental\_prql\_dialect

<ExperimentalBadge />

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

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

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

## allow\_experimental\_ytsaurus\_dictionary\_source

<ExperimentalBadge />

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

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

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

## allow\_experimental\_ytsaurus\_table\_engine

<ExperimentalBadge />

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

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

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

## allow\_experimental\_ytsaurus\_table\_function

<ExperimentalBadge />

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

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

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