> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 세션 설정 > ``system.settings`` 테이블에서 확인할 수 있는 설정입니다. export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => { const cells = [["Type", {type}], ["Default value", {default_value}]]; if (changeable_without_restart) { const isYes = String(changeable_without_restart).trim().toLowerCase() === "yes"; const badge = isYes ? Yes : No; cells.push(["Changeable without restart", badge]); } return {cells.map(([h]) => )} {cells.map(([h, v]) => )}

{h}
{v}

; }; export const CloudOnlyBadge = () => { return

{'ClickHouse Cloud only'}

; }; export const galaxyOnClick = eventName => () => { try { if (typeof window !== "undefined" && window.galaxy && eventName) { window.galaxy.track(eventName, { interaction: "click" }); } } catch (e) {} }; export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => { if (link) { return Beta ; } return

Beta feature. Learn more.

; }; export const ExperimentalBadge = () => { return

Experimental feature. Learn more.

; }; 아래 설정은 모두 테이블(table) [system.settings](/ko/reference/system-tables/settings)에서도 확인할 수 있습니다. 이 설정들은 [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp)에서 자동으로 생성됩니다.

## add\_http\_cors\_header

HTTP CORS 헤더를 추가합니다.

## additional\_result\_filter

`SELECT` 쿼리 결과에 적용하는 추가 필터 표현식입니다. 이 설정은 어떤 하위 쿼리에도 적용되지 않습니다. **예시** ```sql theme={null} INSERT INTO table_1 VALUES (1, 'a'), (2, 'bb'), (3, 'ccc'), (4, 'dddd'); SElECT * FROM table_1; ``` ```response theme={null} ┌─x─┬─y────┐ │ 1 │ a │ │ 2 │ bb │ │ 3 │ ccc │ │ 4 │ dddd │ └───┴──────┘ ``` ```sql theme={null} SELECT * FROM table_1 SETTINGS additional_result_filter = 'x != 2' ``` ```response theme={null} ┌─x─┬─y────┐ │ 1 │ a │ │ 3 │ ccc │ │ 4 │ dddd │ └───┴──────┘ ```

## additional\_table\_filters

지정된 테이블에서 읽어온 후 적용되는 추가 필터 표현식입니다. **예시** ```sql theme={null} INSERT INTO table_1 VALUES (1, 'a'), (2, 'bb'), (3, 'ccc'), (4, 'dddd'); SELECT * FROM table_1; ``` ```response theme={null} ┌─x─┬─y────┐ │ 1 │ a │ │ 2 │ bb │ │ 3 │ ccc │ │ 4 │ dddd │ └───┴──────┘ ``` ```sql theme={null} SELECT * FROM table_1 SETTINGS additional_table_filters = {'table_1': 'x != 2'} ``` ```response theme={null} ┌─x─┬─y────┐ │ 1 │ a │ │ 3 │ ccc │ │ 4 │ dddd │ └───┴──────┘ ```

## aggregate\_function\_input\_format

INSERT 작업 중 AggregateFunction 입력에 사용할 포맷입니다. 가능한 값: * `state` — 직렬화된 상태를 담은 바이너리 문자열입니다(기본값). AggregateFunction 값이 바이너리 데이터로 제공된다고 간주하는 기본 동작입니다. * `value` — 집계 함수 인수의 단일 값 또는 인수가 여러 개인 경우 그 값들의 튜플을 받는 포맷입니다. 해당 값들은 대응하는 IDataType 또는 DataTypeTuple을 사용해 역직렬화된 후 집계되어 상태를 형성합니다. * `array` — 위 `value` 옵션에서 설명한 값들의 배열을 받는 포맷입니다. 배열의 모든 요소가 집계되어 상태를 형성합니다. **예시** 다음 구조를 가진 테이블의 경우: ```sql theme={null} CREATE TABLE example ( user_id UInt64, avg_session_length AggregateFunction(avg, UInt32) ); ``` `aggregate_function_input_format = 'value'`로 설정한 경우: ```sql theme={null} INSERT INTO example FORMAT CSV 123,456 ``` `aggregate_function_input_format = 'array'` 설정 시: ```sql theme={null} INSERT INTO example FORMAT CSV 123,"[456,789,101]" ``` 참고: `value` 및 `array` 포맷은 삽입 시 값을 생성하고 집계해야 하므로 기본 `state` 포맷보다 느립니다.

## aggregate\_functions\_null\_for\_empty

쿼리 내 모든 집계 함수를 재작성하여 [-OrNull](/ko/reference/functions/aggregate-functions/combinators#-ornull) 접미사를 추가하는 기능을 활성화하거나 비활성화합니다. SQL 표준 호환성을 위해 활성화하십시오. 분산 쿼리에서 일관된 결과를 얻기 위해 쿼리 재작성([count\_distinct\_implementation](#count_distinct_implementation) 설정과 유사) 방식으로 구현됩니다. 가능한 값: * 0 — 비활성화됨. * 1 — 활성화됨. **예시** 집계 함수가 포함된 다음 쿼리를 살펴보십시오: ```sql theme={null} SELECT SUM(-1), MAX(0) FROM system.one WHERE 0; ``` `aggregate_functions_null_for_empty = 0`이면 다음과 같이 출력됩니다: ```text theme={null} ┌─SUM(-1)─┬─MAX(0)─┐ │ 0 │ 0 │ └─────────┴────────┘ ``` `aggregate_functions_null_for_empty = 1`로 설정하면 결과는 다음과 같습니다: ```text theme={null} ┌─SUMOrNull(-1)─┬─MAXOrNull(0)─┐ │ NULL │ NULL │ └───────────────┴──────────────┘ ```

## aggregation\_in\_order\_max\_block\_bytes

프라이머리 키 순서대로 집계하는 동안 누적되는 블록의 최대 크기(바이트)입니다. 블록 크기가 작을수록 집계의 최종 머지 단계를 더 잘 병렬화할 수 있습니다.

## aggregation\_memory\_efficient\_merge\_threads

메모리 효율 모드에서 중간 집계 결과를 머지하는 데 사용할 스레드 수입니다. 값이 클수록 메모리 사용량이 늘어납니다. 0은 'max\_threads'와 동일합니다.

## ai\_function\_max\_api\_calls\_per\_query

AI 함수가 쿼리당 보낼 수 있는 최대 HTTP 요청 수입니다. 비활성화하려면 0으로 설정하십시오.

## ai\_function\_max\_input\_tokens\_per\_query

단일 쿼리에서 수행되는 모든 AI 함수 API 호출에 대해 허용되는 최대 총 입력(prompt) 토큰 수입니다. provider의 응답을 기준으로 누적 추적됩니다. 각 호출의 입력 토큰 수는 사전에 알 수 없으므로, 이 제한은 한 번의 호출에 해당하는 입력 토큰 수만큼 초과될 수 있습니다. 비활성화하려면 0으로 설정하십시오.

## ai\_function\_max\_output\_tokens\_per\_query

단일 쿼리에서 수행되는 모든 AI 함수 API 호출의 총 출력(생성) 토큰 수의 최댓값입니다. provider의 응답을 기준으로 누적 추적됩니다. 호출의 출력 토큰 수는 사전에 알 수 없으므로 이 제한은 한 번의 호출에서 생성된 출력 토큰 수만큼 초과될 수 있습니다. 비활성화하려면 0으로 설정하십시오.

## ai\_function\_max\_retries

개별 API 요청에서 일시적인 오류가 발생했을 때 재시도할 수 있는 최대 횟수입니다. 각 재시도에는 `ai_function_retry_initial_delay_ms`를 시작값으로 하는 지수 백오프가 적용됩니다.

## ai\_function\_request\_timeout\_sec

AI 함수가 수행하는 개별 HTTP 요청(AI chat completions 및 embedding API 호출)의 제한 시간(초)입니다. 요청이 이 시간 안에 완료되지 않으면 실패로 간주되며 `ai_function_max_retries` 설정에 따라 재시도될 수 있습니다.

## ai\_function\_retry\_initial\_delay\_ms

실패한 AI 함수 API 요청을 처음 재시도하기 전의 초기 지연 시간(밀리초)입니다. 이후 재시도할 때마다 지연 시간은 2배로 증가합니다(지수 백오프). 예를 들어, 기본 설정에서는 1000ms, 2000ms, 4000ms입니다.

## ai\_function\_throw\_on\_error

true(기본값)인 경우, 모든 재시도를 소진한 후에도 AI 함수 호출이 영구적으로 실패하면 예외를 발생시키고 쿼리를 중단합니다. false인 경우, 실패한 행에는 컬럼 유형의 기본값(String의 경우 빈 문자열)이 적용되며 처리는 계속됩니다.

## ai\_function\_throw\_on\_quota\_exceeded

true(기본값)인 경우 AI 함수 할당량 한도(`ai_function_max_input_tokens_per_query`, `ai_function_max_output_tokens_per_query` 또는 `ai_function_max_api_calls_per_query`)를 초과하면 예외가 발생하며 쿼리가 중단됩니다. false인 경우 남은 행에는 컬럼 유형의 기본값이 적용됩니다(String의 경우 빈 문자열).

## allow\_aggregate\_partitions\_independently

파티션 키가 GROUP BY 키와 잘 맞는 경우, 별도의 스레드에서 파티션을 독립적으로 집계할 수 있도록 합니다. 파티션 수가 코어 수에 가깝고 각 파티션 크기가 대체로 비슷할 때 유용합니다.

## allow\_archive\_path\_syntax

File/S3 엔진/테이블 함수는 아카이브의 확장자가 올바르면 '::'가 포함된 경로를 ` :: `로 해석합니다.

## allow\_asynchronous\_read\_from\_io\_pool\_for\_merge\_tree

MergeTree 테이블을 읽을 때 백그라운드 I/O 풀을 사용합니다. 이 설정은 I/O 제약이 있는 쿼리의 성능을 향상시킬 수 있습니다.

## allow\_calculating\_subcolumns\_sizes\_for\_merge\_tree\_reading

활성화되면 ClickHouse는 작업 및 블록 크기를 더 정확하게 계산할 수 있도록 각 서브컬럼을 읽는 데 필요한 파일 크기를 계산합니다.

## allow\_changing\_replica\_until\_first\_data\_packet

활성화하면 헤지드 요청에서 이미 일부 진행이 있었더라도 첫 번째 데이터 패킷을 받을 때까지 새 연결을 시작할 수 있습니다 (단, `receive_data_timeout` 시간 초과 동안 Progress가 갱신되지 않은 경우). 비활성화하면 처음으로 진행이 발생한 이후에는 레플리카 변경을 허용하지 않습니다.

## allow\_create\_index\_without\_type

TYPE 없이 CREATE INDEX 쿼리를 허용합니다. 해당 쿼리는 무시됩니다. SQL 호환성 테스트용입니다.

## allow\_custom\_error\_code\_in\_throwif

`throwIf()` 함수에서 사용자 지정 오류 코드를 사용할 수 있게 합니다. `true`이면 발생하는 예외에 예상치 못한 오류 코드가 사용될 수 있습니다.

## allow\_ddl

true로 설정된 경우 사용자가 DDL 쿼리를 실행할 수 있습니다.

## allow\_deprecated\_database\_ordinary

더 이상 권장되지 않는 Ordinary engine을 사용해 데이터베이스를 생성할 수 있도록 허용합니다

## allow\_deprecated\_error\_prone\_window\_functions

지원 중단 예정이며 오류가 발생하기 쉬운 윈도우 함수(neighbor, runningAccumulate, runningDifferenceStartingWithFirstValue, runningDifference)의 사용을 허용합니다

## allow\_deprecated\_snowflake\_conversion\_functions

함수 `snowflakeToDateTime`, `snowflakeToDateTime64`, `dateTimeToSnowflake`, `dateTime64ToSnowflake`는 더 이상 권장되지 않으며 기본적으로 비활성화되어 있습니다. 대신 `snowflakeIDToDateTime`, `snowflakeIDToDateTime64`, `dateTimeToSnowflakeID`, `dateTime64ToSnowflakeID` 함수를 사용하십시오. 더 이상 권장되지 않는 함수를 다시 활성화하려면(예: 전환 기간 중) 이 설정을 `true`로 지정하십시오.

## allow\_deprecated\_syntax\_for\_merge\_tree

더 이상 권장되지 않는 엔진 정의 구문을 사용해 \*MergeTree 테이블을 생성하도록 허용합니다

## allow\_distributed\_ddl

true로 설정되면 사용자가 분산 DDL 쿼리를 실행할 수 있습니다.

## allow\_drop\_detached

ALTER TABLE ... DROP DETACHED PART\[ITION] ... 쿼리의 사용을 허용합니다

## allow\_dynamic\_type\_in\_join\_keys

JOIN 키에서 Dynamic 타입 사용을 허용합니다. 호환성을 위해 추가되었습니다. 다른 타입과 비교할 때 예상치 못한 결과가 발생할 수 있으므로 JOIN 키에서 Dynamic 타입을 사용하는 것은 권장되지 않습니다.

## allow\_execute\_multiif\_columnar

multiIf 함수를 열 지향 방식으로 실행하도록 허용합니다

## allow\_experimental\_ai\_functions

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

## allow\_experimental\_analyzer

**별칭**: `enable_analyzer` 새 쿼리 분석기의 사용을 허용합니다.

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

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

## allow\_experimental\_codecs

true로 설정하면 실험적인 압축 코덱을 지정할 수 있습니다(다만 아직 해당 코덱은 없으므로 이 옵션은 아무런 동작도 하지 않습니다).

## allow\_experimental\_correlated\_subqueries

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

## allow\_experimental\_database\_glue\_catalog

**별칭**: `allow_database_glue_catalog` catalog\_type = 'glue'로 설정된 실험적 데이터베이스 엔진 DataLakeCatalog를 허용합니다 Cloud 기본값: `1`.

## allow\_experimental\_database\_hms\_catalog

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

## allow\_experimental\_database\_iceberg

**별칭**: `allow_database_iceberg` `catalog_type = 'iceberg'`인 실험적 데이터베이스 엔진 DataLakeCatalog의 사용을 허용합니다. Cloud 기본값: `1`.

## allow\_experimental\_database\_materialized\_postgresql

Engine=MaterializedPostgreSQL(...)를 사용하는 데이터베이스 생성을 허용합니다.

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

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

## allow\_experimental\_database\_unity\_catalog

**별칭**: `allow_database_unity_catalog` catalog\_type가 'unity'인 실험적 데이터베이스 엔진 DataLakeCatalog의 사용을 허용합니다 Cloud 기본값: `1`.

## allow\_experimental\_delta\_kernel\_rs

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

## allow\_experimental\_delta\_lake\_writes

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

## allow\_experimental\_expire\_snapshots

실험적 Iceberg 명령 `ALTER TABLE ... EXECUTE expire_snapshots`의 실행을 허용합니다.

## allow\_experimental\_funnel\_functions

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

## allow\_experimental\_geo\_types\_in\_iceberg

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

## allow\_experimental\_hash\_functions

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

## allow\_experimental\_iceberg\_compaction

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

## allow\_experimental\_join\_right\_table\_sorting

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

## allow\_experimental\_json\_lazy\_type\_hints

JSON 타입의 실험적 지연 타입 힌트를 활성화합니다. 이 기능은 타입 힌트 평가를 지연하여 JSON 타입 변환을 최적화할 수 있게 합니다.

## allow\_experimental\_kafka\_offsets\_storage\_in\_keeper

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

## allow\_experimental\_kusto\_dialect

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

## allow\_experimental\_materialized\_postgresql\_table

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

## allow\_experimental\_nlp\_functions

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

## allow\_experimental\_nullable\_tuple\_type

테이블에서 [Nullable](/ko/reference/data-types/nullable) [Tuple](/ko/reference/data-types/tuple) 컬럼을 생성할 수 있도록 합니다. 이 설정은 추출된 Tuple 서브컬럼이 `Nullable`이 될 수 있는지 여부는 제어하지 않습니다(예: Dynamic, Variant, JSON 또는 Tuple 컬럼에서 추출된 경우). 추출된 Tuple 서브컬럼이 `Nullable`이 될 수 있는지 제어하려면 `allow_nullable_tuple_in_extracted_subcolumns`를 사용하십시오.

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

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

## allow\_experimental\_paimon\_storage\_engine

Paimon\* 테이블 엔진으로 테이블을 생성할 수 있도록 허용합니다.

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

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

## allow\_experimental\_polyglot\_dialect

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

## allow\_experimental\_prql\_dialect

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

## allow\_experimental\_query\_deduplication

part UUID를 기반으로 한 SELECT 쿼리용 실험적 데이터 중복 제거

## allow\_experimental\_time\_series\_aggregate\_functions

**별칭**: `allow_experimental_ts_to_grid_aggregate_function` Prometheus와 유사한 시계열 리샘플링, rate 및 delta 계산을 위한 실험적인 timeSeries\* 집계 함수입니다.

## allow\_experimental\_time\_series\_table

[TimeSeries](/ko/reference/engines/table-engines/integrations/time-series) 테이블 엔진을 사용하는 테이블의 생성을 허용합니다. 가능한 값은 다음과 같습니다: * 0 — [TimeSeries](/ko/reference/engines/table-engines/integrations/time-series) 테이블 엔진이 비활성화됩니다. * 1 — [TimeSeries](/ko/reference/engines/table-engines/integrations/time-series) 테이블 엔진이 활성화됩니다.

## allow\_experimental\_unique\_key

MergeTree 계열 엔진에서 `UNIQUE KEY` 절이 포함된 테이블을 생성할 수 있도록 합니다.

## allow\_experimental\_window\_view

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

## allow\_experimental\_ytsaurus\_dictionary\_source

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

## allow\_experimental\_ytsaurus\_table\_engine

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

## allow\_experimental\_ytsaurus\_table\_function

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

## allow\_fuzz\_query\_functions

쿼리 문자열에 임의의 AST 뮤테이션을 적용하는 `fuzzQuery` 함수를 활성화합니다.

## allow\_general\_join\_planning

더 복잡한 조건을 처리할 수 있는 더 범용적인 조인 계획 알고리즘을 허용하지만, 해시 조인에서만 작동합니다. 해시 조인이 활성화되어 있지 않으면 이 설정값과 관계없이 일반적인 조인 계획 알고리즘이 사용됩니다.

## allow\_get\_client\_http\_header

현재 HTTP 요청의 헤더 값을 가져올 수 있는 함수 `getClientHTTPHeader`의 사용을 허용합니다. `Cookie`와 같은 일부 헤더에는 민감한 정보가 포함될 수 있으므로, 보안상의 이유로 기본적으로는 활성화되어 있지 않습니다. `X-ClickHouse-*` 및 `Authentication` 헤더는 항상 제한되며, 이 함수로는 가져올 수 없다는 점에 유의하십시오.

## allow\_hyperscan

Hyperscan 라이브러리를 사용하는 함수를 허용합니다. 컴파일 시간이 지나치게 길어지거나 리소스를 과도하게 사용하는 것을 방지하려면 비활성화하십시오.

## allow\_iceberg\_remove\_orphan\_files

Iceberg 테이블에서 'ALTER TABLE ... EXECUTE remove\_orphan\_files()'를 사용할 수 있도록 합니다.

## allow\_insert\_into\_iceberg

**별칭**: `allow_experimental_insert_into_iceberg` Iceberg에 `insert` 쿼리를 실행하도록 허용합니다.

## allow\_introspection\_functions

쿼리 프로파일링에 사용할 [인트로스펙션 함수](/ko/reference/functions/regular-functions/introspection)를 활성화하거나 비활성화합니다. 가능한 값: * 1 — 인트로스펙션 함수가 활성화됩니다. * 0 — 인트로스펙션 함수가 비활성화됩니다. **관련 항목** * [Sampling Query Profiler](/ko/concepts/features/performance/troubleshoot/sampling-query-profiler) * 시스템 테이블 [trace\_log](/ko/reference/system-tables/trace_log)

## allow\_key\_condition\_coalesce\_rewrite

const` 형태의 프레디케이트(`ifNull` 형태나 상수가 왼쪽에 있는 동등한 경우 포함)를 논리합으로 재작성하는 새로운 설정입니다. 이를 통해 각 `a_i`에 대한 컬럼별 프라이머리 키와 스킵 인덱스를 사용할 수 있습니다. `coalesce(a, 42, b)` 및 `coalesce(a, b, 42)`와 같은 일부 상수 포함 형태도 처리합니다."}]}]} /> 인덱스 분석 전에 `coalesce(a_1, ..., a_N) const` 형태의 프레디케이트(`ifNull` 형태나 상수가 왼쪽에 있는 동등한 경우 포함)를 `(a_1 const) OR (a_1 IS NULL AND a_2 const) OR ... OR (a_1 IS NULL AND ... AND a_{N-1} IS NULL AND a_N const)` 형태의 논리합으로 재작성하므로, 각 `a_i`에 대한 컬럼별 프라이머리 키와 스킵 인덱스를 사용할 수 있습니다. `coalesce(a, 42, b)` 및 `coalesce(a, b, 42)`와 같은 일부 상수 포함 형태도 처리합니다. 인수 목록은 `coalesce` 자체와 마찬가지로 정규화되며(`NULL` 리터럴은 제거되고, 첫 번째 비-`Nullable` 인수 뒤의 인수는 제거됨), 후행 비-`NULL` 상수가 있으면 마지막 분기로 내보냅니다. 이 재작성은 인덱스 프루닝에만 추가로 적용되며, 런타임 필터링에는 계속 원래 프레디케이트를 사용합니다.

## allow\_materialized\_view\_with\_bad\_select

존재하지 않는 테이블 또는 컬럼을 참조하는 SELECT 쿼리가 포함된 CREATE MATERIALIZED VIEW를 허용합니다. 다만 구문상으로는 여전히 유효해야 합니다. 갱신 가능한 MV에는 적용되지 않습니다. 또한 SELECT 쿼리에서 MV 스키마를 추론해야 하는 경우(즉, CREATE에 컬럼 목록이 없고 TO 테이블도 없는 경우)에도 적용되지 않습니다. 원본 테이블보다 먼저 MV를 생성할 때 사용할 수 있습니다.

## allow\_named\_collection\_override\_by\_default

이름이 지정된 컬렉션의 필드 재정의를 기본적으로 허용합니다.

## allow\_non\_metadata\_alters

테이블 메타데이터뿐 아니라 디스크의 데이터에도 영향을 주는 alter 실행을 허용합니다.

## allow\_nonconst\_timezone\_arguments

toTimeZone(), fromUnixTimestamp\*(), snowflakeToDateTime\*()와 같은 특정 시간 관련 함수에서 상수가 아닌 시간대 인수를 허용합니다. 이 설정은 호환성을 위해서만 존재합니다. ClickHouse에서 시간대는 데이터 타입, 즉 컬럼의 속성입니다. 이 설정을 활성화하면 하나의 컬럼 안에서 서로 다른 값이 서로 다른 시간대를 가질 수 있다는 잘못된 인상을 줄 수 있습니다. 따라서 이 설정은 활성화하지 마십시오.

## allow\_nondeterministic\_mutations

`dictGet`과 같은 비결정적 함수를 복제된 테이블(Replicated Table)의 뮤테이션에 사용할 수 있도록 허용하는 사용자 수준 설정입니다. 예를 들어 딕셔너리는 노드 간 동기화 상태가 서로 다를 수 있으므로, 딕셔너리에서 값을 가져오는 뮤테이션은 기본적으로 복제된 테이블에서 허용되지 않습니다. 이 설정을 활성화하면 이러한 동작이 가능해지며, 사용되는 데이터가 모든 노드에서 동기화되어 있는지 확인하는 책임은 사용자에게 있습니다. **예시** ```xml theme={null} 1 ```

## allow\_nondeterministic\_optimize\_skip\_unused\_shards

세그먼트 분할 키(sharding key)에서 비결정적 함수(`rand` 또는 `dictGet` 등, 단 후자는 업데이트와 관련해 몇 가지 주의 사항이 있음)를 허용합니다. 가능한 값: * 0 — 허용되지 않습니다. * 1 — 허용됩니다.

## allow\_nullable\_tuple\_in\_extracted\_subcolumns

`Tuple(...)` 유형의 추출된 서브컬럼을 `Nullable(Tuple(...))`로 지정할 수 있는지 제어합니다. * `false`: `Tuple(...)`를 반환하고, 서브컬럼이 없는 행에는 기본 tuple 값을 사용합니다. * `true`: `Nullable(Tuple(...))`를 반환하고, 서브컬럼이 없는 행에는 `NULL`을 사용합니다. 이 설정은 추출된 서브컬럼의 동작만 제어합니다. 테이블에서 `Nullable(Tuple(...))` 컬럼을 생성할 수 있는지 여부는 제어하지 않습니다. 이는 `allow_experimental_nullable_tuple_type`에서 제어합니다. ClickHouse는 서버 시작 시 로드된 이 설정 값을 사용합니다. `SET` 또는 쿼리 수준의 `SETTINGS`로 변경해도 추출된 서브컬럼 동작은 바뀌지 않습니다. 추출된 서브컬럼 동작을 변경하려면 시작 프로필 구성(예: users.xml)에서 `allow_nullable_tuple_in_extracted_subcolumns`를 업데이트한 후 서버를 다시 시작하십시오.

## allow\_prefetched\_read\_pool\_for\_local\_filesystem

모든 파트가 로컬 파일 시스템에 있으면 prefetched 스레드 풀을 우선 사용합니다

## allow\_prefetched\_read\_pool\_for\_remote\_filesystem

모든 파트가 원격 파일 시스템에 있는 경우 prefetched 스레드 풀을 우선 사용합니다

## allow\_push\_predicate\_ast\_for\_distributed\_subqueries

analyzer가 활성화된 분산 서브쿼리에서 AST 수준의 프레디케이트 푸시를 허용합니다

## allow\_push\_predicate\_when\_subquery\_contains\_with

서브쿼리에 WITH 절이 포함된 경우에도 push predicate를 허용합니다

## allow\_rank\_dense\_rank\_arguments

하위 호환성을 위해 `RANK` 및 `DENSE_RANK` 윈도우 함수에 인수를 전달할 수 있도록 허용합니다. SQL 표준에 따르면 `RANK` 및 `DENSE_RANK`는 인수를 받지 않습니다. 즉, 이 함수들은 `OVER (ORDER BY ...)` 윈도우만 기준으로 행의 순위를 매깁니다. ClickHouse 26.5 이전 버전에서는 `RANK(x) OVER (...)`와 같은 쿼리에서 인수를 아무 경고 없이 받아들인 뒤 무시했기 때문에 사용자에게 혼란을 주었습니다 (표시된 인수가 순위 계산에 영향을 주는 것처럼 보이지만 실제로는 그렇지 않았습니다). 이 설정이 `false`(기본값)이면 `RANK` 및 `DENSE_RANK`는 모든 인수를 거부하고 `NUMBER_OF_ARGUMENTS_DOESNT_MATCH` 예외를 발생시킵니다. `true`로 설정하면 이전의 완화된 동작이 복원되며, 26.5 이전과 같이 인수가 아무 경고 없이 무시됩니다.

## allow\_reorder\_prewhere\_conditions

조건을 WHERE에서 PREWHERE로 이동할 때, 필터링 최적화를 위해 조건의 순서를 재정렬할 수 있습니다

## allow\_settings\_after\_format\_in\_insert

`INSERT` 쿼리에서 `FORMAT` 뒤에 `SETTINGS`를 허용할지 여부를 제어합니다. `SETTINGS`의 일부가 값으로 해석될 수 있으므로, 사용은 권장되지 않습니다. 예시: ```sql theme={null} INSERT INTO FUNCTION null('foo String') SETTINGS max_threads=1 VALUES ('bar'); ``` 하지만 다음 쿼리는 `allow_settings_after_format_in_insert`를 활성화한 경우에만 동작합니다: ```sql theme={null} SET allow_settings_after_format_in_insert=1; INSERT INTO FUNCTION null('foo String') VALUES ('bar') SETTINGS max_threads=1; ``` 가능한 값: * 0 — 허용하지 않습니다. * 1 — 허용합니다. 사용 사례가 이전 구문에 의존하는 경우에만 이전 버전과의 호환성을 위해 이 설정을 사용하세요.

## allow\_simdjson

AVX2 명령어를 사용할 수 있는 경우 'JSON\*' 함수에서 simdjson 라이브러리를 사용할 수 있도록 합니다. 비활성화하면 rapidjson을 사용합니다.

## allow\_special\_serialization\_kinds\_in\_output\_formats

Sparse 및 Replicated와 같은 특수 직렬화 종류를 사용하는 컬럼을 완전한 컬럼 표현으로 변환하지 않고 출력할 수 있도록 합니다. 이렇게 하면 formatting 중 불필요한 데이터 복사를 줄이는 데 도움이 됩니다.

## allow\_statistics

**별칭**: `allow_experimental_statistics` 컬럼에 [통계](/ko/reference/engines/table-engines/mergetree-family/mergetree#table_engine-mergetree-creating-a-table)를 정의하고 [통계](/ko/reference/engines/table-engines/mergetree-family/mergetree#column-statistics)를 관리할 수 있습니다.

## allow\_statistics\_optimize

**별칭**: `allow_statistic_optimize` 통계를 사용한 쿼리 최적화를 허용합니다

## allow\_suspicious\_codecs

true로 설정하면 무의미한 압축 코덱을 지정할 수 있습니다.

## allow\_suspicious\_fixed\_string\_types

CREATE TABLE 문에서 n > 256인 FixedString(n) 타입의 컬럼을 생성할 수 있도록 허용합니다. 길이가 256 이상인 FixedString은 의심스러우며, 대개 잘못 사용되었음을 의미합니다.

## allow\_suspicious\_indices

동일한 표현식을 사용하는 프라이머리/보조 인덱스와 정렬 키를 거부합니다

## allow\_suspicious\_low\_cardinality\_types

8바이트 이하의 고정 크기를 갖는 데이터 타입, 즉 숫자 데이터 타입과 `FixedString(8_bytes_or_less)`에 [LowCardinality](/ko/reference/data-types/lowcardinality)를 사용할 수 있도록 허용하거나 제한합니다. 작은 고정값에 `LowCardinality`를 사용하는 것은 일반적으로 비효율적입니다. ClickHouse는 각 행마다 숫자 인덱스를 저장하기 때문입니다. 그 결과 다음과 같은 문제가 발생할 수 있습니다. * 디스크 공간 사용량이 늘어날 수 있습니다. * 딕셔너리 크기에 따라 RAM 사용량이 더 높아질 수 있습니다. * 추가 코딩/인코딩 작업으로 인해 일부 함수가 더 느리게 동작할 수 있습니다. 위에서 설명한 모든 이유로 인해 [MergeTree](/ko/reference/engines/table-engines/mergetree-family/mergetree) 엔진 테이블의 머지 시간이 늘어날 수 있습니다. 가능한 값: * 1 — `LowCardinality` 사용이 제한되지 않습니다. * 0 — `LowCardinality` 사용이 제한됩니다.

## allow\_suspicious\_primary\_key

MergeTree에서 문제가 있을 수 있는 `PRIMARY KEY`/`ORDER BY`(예: SimpleAggregateFunction)를 허용합니다.

## allow\_suspicious\_ttl\_expressions

테이블의 어떤 컬럼에도 의존하지 않는 TTL 표현식은 거부합니다. 대부분 사용자 오류를 의미합니다.

## allow\_suspicious\_types\_in\_group\_by

GROUP BY 키로 [Variant](/ko/reference/data-types/variant) 및 [Dynamic](/ko/reference/data-types/dynamic) 타입을 사용하는 것을 허용하거나 제한합니다.

## allow\_suspicious\_types\_in\_order\_by

ORDER BY 키에서 [Variant](/ko/reference/data-types/variant) 및 [Dynamic](/ko/reference/data-types/dynamic) 타입의 사용 허용 여부를 제어합니다.

## allow\_suspicious\_variant\_types

CREATE TABLE 문에서 서로 유사한 variant type(예: 서로 다른 숫자형 또는 날짜형 타입)을 포함하는 Variant 타입을 지정할 수 있도록 합니다. 이 설정을 활성화하면 유사한 타입의 값을 다룰 때 일부 모호성이 생길 수 있습니다.

## allow\_unrestricted\_reads\_from\_keeper

system.zookeeper 테이블에서 제한 없이(경로 조건 없이) 읽는 것을 허용합니다. 편리할 수 있지만 ZooKeeper에는 안전하지 않습니다.

## alter\_move\_to\_space\_execute\_async

ALTER TABLE MOVE ... TO \[DISK|VOLUME] 명령을 비동기적으로 실행합니다

## alter\_partition\_verbose\_result

파티션 및 파트 조작 작업이 성공적으로 적용된 파트에 대한 정보 표시를 활성화하거나 비활성화합니다. [ATTACH PARTITION|PART](/ko/reference/statements/alter/partition#attach-partitionpart) 및 [FREEZE PARTITION](/ko/reference/statements/alter/partition#freeze-partition)에 적용됩니다. 가능한 값: * 0 — 자세히 표시하지 않습니다. * 1 — 자세히 표시합니다. **예시** ```sql theme={null} CREATE TABLE test(a Int64, d Date, s String) ENGINE = MergeTree PARTITION BY toYYYYMDECLARE(d) ORDER BY a; INSERT INTO test VALUES(1, '2021-01-01', ''); INSERT INTO test VALUES(1, '2021-01-01', ''); ALTER TABLE test DETACH PARTITION ID '202101'; ALTER TABLE test ATTACH PARTITION ID '202101' SETTINGS alter_partition_verbose_result = 1; ┌─command_type─────┬─partition_id─┬─part_name────┬─old_part_name─┐ │ ATTACH PARTITION │ 202101 │ 202101_7_7_0 │ 202101_5_5_0 │ │ ATTACH PARTITION │ 202101 │ 202101_8_8_0 │ 202101_6_6_0 │ └──────────────────┴──────────────┴──────────────┴───────────────┘ ALTER TABLE test FREEZE SETTINGS alter_partition_verbose_result = 1; ┌─command_type─┬─partition_id─┬─part_name────┬─backup_name─┬─backup_path───────────────────┬─part_backup_path────────────────────────────────────────────┐ │ FREEZE ALL │ 202101 │ 202101_7_7_0 │ 8 │ /var/lib/clickhouse/shadow/8/ │ /var/lib/clickhouse/shadow/8/data/default/test/202101_7_7_0 │ │ FREEZE ALL │ 202101 │ 202101_8_8_0 │ 8 │ /var/lib/clickhouse/shadow/8/ │ /var/lib/clickhouse/shadow/8/data/default/test/202101_8_8_0 │ └──────────────┴──────────────┴──────────────┴─────────────┴───────────────────────────────┴─────────────────────────────────────────────────────────────┘ ```

## alter\_sync

**별칭**: `replication_alter_partitions_sync` [`ALTER`](/ko/reference/statements/alter), [`OPTIMIZE`](/ko/reference/statements/optimize) 또는 [`TRUNCATE`](/ko/reference/statements/truncate) 쿼리로 레플리카에서 실행되는 작업에 대해 어떻게 대기할지 지정합니다. 가능한 값: * `0` — 대기하지 않습니다. * `1` — 자체 실행이 완료될 때까지 대기합니다. * `2` — 모두의 실행이 완료될 때까지 대기합니다. * `3` - 활성 레플리카의 실행이 완료될 때까지만 대기합니다. Cloud 기본값: `0`. `alter_sync`는 `Replicated` 및 `SharedMergeTree` 테이블에만 적용되며, `Replicated` 또는 `Shared`가 아닌 테이블에 대해서는 아무런 동작도 하지 않습니다.

## alter\_update\_mode

`UPDATE` 명령을 포함한 `ALTER` 쿼리에 사용하는 모드입니다. 가능한 값: * `heavy` - 일반 mutation을 실행합니다. * `lightweight` - 가능하면 경량 업데이트를 실행하고, 그렇지 않으면 일반 mutation을 실행합니다. * `lightweight_force` - 가능하면 경량 업데이트를 실행하고, 그렇지 않으면 예외를 발생시킵니다.

## analyze\_index\_with\_space\_filling\_curves

테이블의 인덱스에 공간 충전 곡선이 포함되어 있고(예: `ORDER BY mortonEncode(x, y)` 또는 `ORDER BY hilbertEncode(x, y)`), 쿼리에 해당 인수에 대한 조건이 있는 경우(예: `x >= 10 AND x <= 20 AND y >= 20 AND y <= 30`), 인덱스 분석에 공간 충전 곡선을 사용합니다.

## analyzer\_compatibility\_allow\_compound\_identifiers\_in\_unflatten\_nested

nested에 복합 식별자를 추가할 수 있도록 허용합니다. 이 설정은 쿼리 결과를 변경할 수 있으므로 호환성 설정입니다. 비활성화하면 `SELECT a.b.c FROM table ARRAY JOIN a`는 작동하지 않고, `SELECT a FROM table`에는 `Nested a` 결과에 `a.b.c` 컬럼이 포함되지 않습니다.

## analyzer\_compatibility\_join\_using\_top\_level\_identifier

JOIN USING의 식별자를 projection에서 해석하도록 강제합니다(예를 들어 `SELECT a + 1 AS b FROM t1 JOIN t2 USING (b)`에서는 `t1.b = t2.b`가 아니라 `t1.a + 1 = t2.b`를 기준으로 join이 수행됩니다).

## analyzer\_inline\_views

활성화되면 분석기가 일반 뷰(구체화되지 않고 매개변수화되지 않은 뷰)를 해당 뷰를 정의하는 서브쿼리로 대체하여, 프레디케이트 푸시다운 및 컬럼 프루닝과 같은 경계를 가로지르는 최적화를 수행할 수 있습니다.

## any\_join\_distinct\_right\_table\_keys

`ANY INNER|LEFT JOIN` 연산에서 ClickHouse 서버의 기존 동작 방식을 활성화합니다. 사용 사례가 기존 `JOIN` 동작에 의존하는 경우에만 하위 호환성을 위해 이 설정을 사용하십시오. 기존 방식이 활성화되면 다음과 같습니다: * ClickHouse가 왼쪽에서 오른쪽으로의 다대일 테이블 키 매핑 로직을 사용하므로 `t1 ANY LEFT JOIN t2` 및 `t2 ANY RIGHT JOIN t1` 연산 결과는 서로 동일하지 않습니다. * `ANY INNER JOIN` 연산 결과에는 `SEMI LEFT JOIN` 연산과 마찬가지로 왼쪽 테이블의 모든 행이 포함됩니다. 기존 방식이 비활성화되면 다음과 같습니다: * ClickHouse가 `ANY RIGHT JOIN` 연산에서 일대다 키 매핑을 제공하는 로직을 사용하므로 `t1 ANY LEFT JOIN t2` 및 `t2 ANY RIGHT JOIN t1` 연산 결과는 서로 동일합니다. * `ANY INNER JOIN` 연산 결과에는 왼쪽 및 오른쪽 테이블 모두에서 각 키당 하나의 행이 포함됩니다. 가능한 값: * 0 — 기존 방식이 비활성화됩니다. * 1 — 기존 방식이 활성화됩니다. 관련 항목: * [JOIN 엄격성](/ko/reference/statements/select/join#settings)

## apply\_deleted\_mask

경량한 삭제로 삭제된 행을 필터링할 수 있도록 합니다. 비활성화하면 쿼리에서 해당 행을 읽을 수 있습니다. 이는 디버깅 및 "삭제 복구" 시나리오에 유용합니다.

## apply\_mutations\_on\_fly

true인 경우, 데이터 파트에 구체화되지 않은 뮤테이션(UPDATE 및 DELETE)이 SELECT 시 적용됩니다.

## apply\_patch\_parts

`true`이면 경량 업데이트를 나타내는 patch parts가 SELECT 시 적용됩니다.

## apply\_patch\_parts\_join\_cache\_buckets

Join 모드에서 patch parts 적용을 위한 임시 캐시의 버킷 수입니다.

## apply\_prewhere\_after\_final

활성화하면 ReplacingMergeTree 및 유사한 엔진에서 PREWHERE 조건이 FINAL 처리 후에 적용됩니다. 이는 PREWHERE가 중복된 행들 사이에서 값이 달라질 수 있는 컬럼을 참조하고, 필터링하기 전에 FINAL이 최종적으로 선택될 행을 먼저 결정하도록 하려는 경우에 유용합니다. 비활성화하면 PREWHERE는 읽는 중에 적용됩니다. 참고: apply\_row\_level\_security\_after\_final이 활성화되어 있고 행 정책이 정렬 키가 아닌 컬럼을 사용하는 경우, 올바른 실행 순서를 유지하기 위해 PREWHERE도 지연됩니다(행 정책은 PREWHERE보다 먼저 적용되어야 합니다).

## apply\_row\_policy\_after\_final

활성화하면 \*MergeTree 테이블에서 FINAL 처리 후에 행 정책과 PREWHERE가 적용됩니다. (특히 ReplacingMergeTree에서 해당됩니다.) 비활성화하면 행 정책은 FINAL 전에 적용되며, 이 경우 정책이 ReplacingMergeTree 또는 유사한 엔진에서 중복 제거에 사용되어야 하는 행을 필터링하면 결과가 달라질 수 있습니다. 행 정책 표현식이 ORDER BY의 컬럼에만 의존하는 경우에는 최적화를 위해 여전히 FINAL 전에 적용됩니다. 이러한 필터링은 중복 제거 결과에 영향을 주지 않기 때문입니다. 가능한 값: * 0 — 행 정책과 PREWHERE가 FINAL 전에 적용됩니다(기본값). * 1 — 행 정책과 PREWHERE가 FINAL 후에 적용됩니다.

## apply\_settings\_from\_server

클라이언트가 서버에서 설정을 받아들일지 여부입니다. 이 설정은 클라이언트 측에서 수행되는 작업에만 영향을 미치며, 특히 INSERT 입력 데이터의 파싱과 쿼리 결과의 형식 지정에 적용됩니다. 대부분의 쿼리 실행은 서버에서 이루어지므로 이 설정의 영향을 받지 않습니다. 일반적으로 이 설정은 클라이언트(클라이언트 명령줄 인수, `SET` 쿼리 또는 `SELECT` 쿼리의 `SETTINGS` 섹션)가 아니라 사용자 프로필(users.xml 또는 `ALTER USER` 같은 쿼리)에서 설정해야 합니다. 클라이언트를 통해 false로 변경할 수는 있지만 true로는 변경할 수 없습니다(사용자 프로필에 `apply_settings_from_server = false`가 설정되어 있으면 서버가 설정을 보내지 않기 때문입니다). 참고로 초기에(24.12) 서버 설정(`send_settings_to_client`)이 있었지만, 이후 사용성을 개선하기 위해 이 클라이언트 설정으로 대체되었습니다.

## archive\_adaptive\_buffer\_max\_size\_bytes

아카이브 파일(예: tar 아카이브)에 쓸 때 사용되는 적응형 버퍼의 최대 크기를 제한합니다.

## arrow\_flight\_request\_descriptor\_type

Arrow Flight 요청에 사용할 디스크립터 유형입니다. 'path'는 데이터셋 이름을 경로 디스크립터로 전송합니다. 'command'는 SQL 쿼리를 명령 디스크립터로 전송합니다(Dremio에 필요함). 가능한 값: * 'path' — FlightDescriptor::Path를 사용합니다(기본값이며, 대부분의 Arrow Flight 서버에서 작동함) * 'command' — SELECT 쿼리와 함께 FlightDescriptor::Command를 사용합니다(Dremio에 필요함)

## ast\_fuzzer\_any\_query

false(기본값)인 경우 서버 측 AST 퍼저(`ast_fuzzer_runs`로 제어)는 읽기 전용 쿼리(SELECT, EXPLAIN, SHOW, DESCRIBE, EXISTS)만 퍼징합니다. true인 경우에는 DDL 및 INSERT를 포함한 모든 쿼리 타입을 퍼징합니다.

## ast\_fuzzer\_runs

일반 쿼리가 실행될 때마다 그 뒤에 무작위 쿼리를 실행하고 결과는 폐기하는 서버 측 AST 퍼저를 활성화합니다. * 0: 비활성화(기본값)입니다. * 0보다 크고 1보다 작은 값: 퍼즈된 쿼리 1개를 실행할 확률입니다. * 1 이상인 값: 일반 쿼리마다 실행할 퍼즈된 쿼리 수입니다. 퍼저는 모든 세션의 모든 쿼리에서 AST 조각을 누적하며, 시간이 지날수록 점점 더 흥미로운 뮤테이션을 생성합니다. 실패한 퍼즈 쿼리는 자동으로 폐기되며, 결과는 클라이언트에 반환되지 않습니다.

## asterisk\_include\_alias\_columns

와일드카드 쿼리(`SELECT *`)에 [ALIAS](/ko/reference/statements/create/table#alias) 컬럼을 포함합니다. 가능한 값: * 0 - 비활성화됨 * 1 - 활성화됨

## asterisk\_include\_materialized\_columns

와일드카드 쿼리(`SELECT *`)에 [MATERIALIZED](/ko/reference/statements/create/view#materialized-view) 컬럼을 포함할지 설정합니다. 사용 가능한 값: * 0 - 비활성화 * 1 - 활성화

## asterisk\_include\_virtual\_columns

와일드카드 쿼리(`SELECT *`)에 가상 컬럼을 포함합니다. 가능한 값: * 0 - 비활성화됨 * 1 - 활성화됨

## async\_insert

true인 경우, INSERT 쿼리의 데이터는 큐에 저장되며 이후 백그라운드에서 테이블로 플러시됩니다. wait\_for\_async\_insert가 false이면 INSERT 쿼리는 거의 즉시 처리되며, 그렇지 않으면 클라이언트는 데이터가 테이블로 플러시될 때까지 기다립니다.

## async\_insert\_busy\_timeout\_decrease\_rate

적응형 비동기 삽입 타임아웃 감소 시 적용되는 지수 증가율

## async\_insert\_busy\_timeout\_increase\_rate

적응형 비동기 삽입 타임아웃이 증가할 때의 지수 증가율

## async\_insert\_busy\_timeout\_max\_ms

**별칭**: `async_insert_busy_timeout_ms` 첫 번째 데이터가 도착한 시점부터, 쿼리별로 수집된 데이터를 덤프하기 전까지 대기하는 최대 시간입니다. Cloud 기본값: `1000` (1s).

## async\_insert\_busy\_timeout\_min\_ms

async\_insert\_use\_adaptive\_busy\_timeout을 통해 자동 조정이 활성화된 경우, 첫 데이터가 들어온 시점부터 쿼리별로 수집된 데이터를 기록하기 전까지 대기하는 최소 시간입니다. 또한 적응형 알고리즘의 초기값으로도 사용됩니다.

## async\_insert\_deduplicate

복제된 테이블(Replicated Table)에서 async INSERT 쿼리의 삽입 블록에 대해 중복 제거를 수행할지 지정합니다.

## async\_insert\_max\_data\_size

삽입되기 전에 쿼리별로 수집되는 미파싱 데이터의 최대 크기(바이트) Cloud 기본값: `104857600` (100 MiB).

## async\_insert\_max\_query\_number

삽입이 수행되기 전까지 허용되는 최대 삽입 쿼리 수입니다. 이 설정은 [`async_insert_deduplicate`](#async_insert_deduplicate)가 1인 경우에만 적용됩니다.

## async\_insert\_poll\_timeout\_ms

비동기 삽입 큐의 데이터를 폴링할 때의 timeout

## async\_insert\_use\_adaptive\_busy\_timeout

true로 설정하면 비동기 삽입에 적응형 busy 타임아웃을 사용합니다

## async\_query\_sending\_for\_remote

원격 쿼리 실행 시 연결 생성과 쿼리 전송을 비동기로 수행하도록 합니다. 기본적으로 활성화되어 있습니다.

## async\_socket\_for\_remote

원격 쿼리를 실행할 때 소켓에서 비동기적으로 읽도록 합니다. 기본적으로 활성화되어 있습니다.

## automatic\_parallel\_replicas\_min\_bytes\_per\_replica

병렬 레플리카를 자동으로 활성화하기 위해 레플리카당 읽어야 하는 바이트 수의 임계값입니다(`automatic_parallel_replicas_mode`=1인 경우에만 적용됨). 0은 임계값이 없음을 의미합니다. 읽어야 하는 총 바이트 수는 수집된 통계를 기반으로 추정됩니다.

## automatic\_parallel\_replicas\_mode

수집된 통계를 기반으로 병렬 레플리카를 사용한 실행으로 자동 전환할지 설정합니다. 이를 사용하려면 `enable_analyzer = 1`, `enable_parallel_replicas != 0`, `parallel_replicas_local_plan = 1`이 필요하며, `cluster_for_parallel_replicas`도 제공해야 합니다. 0 - 비활성화, 1 - 활성화, 2 - 통계 수집만 활성화됨(병렬 레플리카를 사용한 실행으로의 전환은 비활성화됨).

## azure\_allow\_parallel\_part\_upload

Azure 멀티파트 업로드에 여러 스레드를 사용합니다.

## azure\_check\_objects\_after\_upload

Azure blob storage에 업로드된 각 객체를 검사하여 업로드가 정상적으로 완료되었는지 확인합니다

## azure\_connect\_timeout\_ms

Azure 디스크 호스트의 연결 타임아웃입니다.

## azure\_create\_new\_file\_on\_insert

Azure engine 테이블에서 각 삽입 시 새 파일을 생성할지 여부를 설정합니다

## azure\_ignore\_file\_doesnt\_exist

특정 키를 읽을 때 파일이 존재하지 않더라도 이를 무시합니다. Possible values: * 1 — `SELECT`는 빈 결과를 반환합니다. * 0 — `SELECT`는 예외를 발생시킵니다.

## azure\_list\_object\_keys\_size

ListObject 요청으로 한 번에 반환할 수 있는 최대 파일 수

## azure\_max\_blocks\_in\_multipart\_upload

Azure 멀티파트 업로드의 최대 블록 수입니다.

## azure\_max\_get\_burst

초당 요청 수 제한에 도달하기 전에 동시에 실행할 수 있는 최대 요청 수입니다. 기본값(0)은 `azure_max_get_rps`와 같습니다.

## azure\_max\_get\_rps

스로틀링이 시작되기 전까지 허용되는 Azure GET 요청의 초당 수 제한입니다. 0은 무제한을 의미합니다.

## azure\_max\_inflight\_parts\_for\_one\_file

멀티파트 업로드 요청에서 동시에 업로드할 수 있는 파트의 최대 개수입니다. 0은 무제한입니다.

## azure\_max\_put\_burst

초당 요청 수 제한에 도달하기 전에 동시에 보낼 수 있는 최대 요청 수입니다. 기본값(0)은 `azure_max_put_rps`와 동일합니다.

## azure\_max\_put\_rps

스로틀링이 적용되기 전 Azure PUT request의 초당 요청 수 제한입니다. 0은 무제한을 의미합니다.

## azure\_max\_redirects

허용되는 Azure 리디렉션 홉의 최대 수입니다.

## azure\_max\_single\_part\_copy\_size

Azure blob storage에 단일 파트 복사 방식으로 복사할 수 있는 객체의 최대 크기입니다.

## azure\_max\_single\_part\_upload\_size

Azure blob storage에 단일 파트 업로드(singlepart upload)로 업로드할 수 있는 객체의 최대 크기입니다.

## azure\_max\_single\_read\_retries

Azure blob storage에서 단일 읽기를 수행할 때 재시도할 수 있는 최대 횟수입니다.

## azure\_max\_unexpected\_write\_error\_retries

Azure blob storage에 쓰는 중 예기치 않은 오류가 발생했을 때의 최대 재시도 횟수

## azure\_max\_upload\_part\_size

Azure blob storage에 멀티파트 업로드를 수행할 때 업로드할 파트의 최대 크기입니다.

## azure\_min\_upload\_part\_size

Azure blob storage로 멀티파트 업로드를 수행할 때 각 업로드 파트의 최소 크기입니다.

## azure\_request\_timeout\_ms

Azure로 데이터를 송수신할 때 적용되는 유휴 시간 제한입니다. 단일 TCP 읽기 또는 쓰기 호출이 이 시간 동안 블로킹되면 실패합니다.

## azure\_sdk\_max\_retries

Azure SDK의 최대 재시도 횟수

## azure\_sdk\_retry\_initial\_backoff\_ms

Azure SDK의 재시도 사이 최소 백오프

## azure\_sdk\_retry\_max\_backoff\_ms

Azure SDK의 재시도 간 최대 백오프

## azure\_skip\_empty\_files

S3 엔진에서 빈 파일 건너뛰기를 활성화하거나 비활성화합니다. 가능한 값: * 0 — 빈 파일이 요청된 포맷과 호환되지 않으면 `SELECT`가 예외를 발생시킵니다. * 1 — 빈 파일에 대해 `SELECT`는 빈 결과를 반환합니다.

## azure\_strict\_upload\_part\_size

Azure Blob Storage로 멀티파트 업로드를 수행할 때 각 업로드 파트의 정확한 크기입니다.

## azure\_throw\_on\_zero\_files\_match

glob 확장 규칙에 따라 일치하는 파일이 0개이면 오류를 발생시킵니다. 가능한 값: * 1 — `SELECT`가 예외를 발생시킵니다. * 0 — `SELECT`가 빈 결과를 반환합니다.

## azure\_truncate\_on\_insert

azure 엔진 테이블에서 삽입 전에 TRUNCATE를 수행할지 여부를 설정합니다.

## azure\_upload\_part\_size\_multiply\_factor

Azure blob storage에 대한 단일 쓰기에서 azure\_multiply\_parts\_count\_threshold개의 파트가 업로드될 때마다 azure\_min\_upload\_part\_size에 이 계수를 곱합니다.

## azure\_upload\_part\_size\_multiply\_parts\_count\_threshold

이 개수만큼의 파트가 Azure blob storage에 업로드될 때마다 azure\_min\_upload\_part\_size에 azure\_upload\_part\_size\_multiply\_factor를 곱합니다.

## azure\_use\_adaptive\_timeouts

`true`로 설정하면 모든 Azure 요청에서 처음 두 번의 시도는 더 짧은 송신 및 수신 timeout으로 수행됩니다. `false`로 설정하면 모든 시도가 동일한 timeout으로 수행됩니다.

## backup\_restore\_batch\_size\_for\_keeper\_multi

백업 또는 복원 중 \[Zoo]Keeper로 보내는 다중 요청의 Batch 최대 크기

## backup\_restore\_batch\_size\_for\_keeper\_multiread

백업 또는 복원 중 \[Zoo]Keeper에 대한 multiread 요청에 사용되는 Batch의 최대 크기

## backup\_restore\_failure\_after\_host\_disconnected\_for\_seconds

BACKUP ON CLUSTER 또는 RESTORE ON CLUSTER 작업 중 호스트가 이 시간 동안 ZooKeeper에 임시 'alive' 노드를 다시 생성하지 못하면 전체 백업 또는 복원은 실패한 것으로 간주됩니다. 이 값은 장애 발생 후 호스트가 ZooKeeper에 다시 연결하는 데 필요한 합리적인 최대 시간보다 크게 설정해야 합니다. 0은 무제한을 의미합니다.

## backup\_restore\_finish\_timeout\_after\_error\_sec

현재 BACKUP ON CLUSTER 또는 RESTORE ON CLUSTER 작업에서 시작 노드가 다른 호스트가 '오류' 노드에 반응하여 작업을 중지할 때까지 대기하는 시간을 지정합니다.

## backup\_restore\_keeper\_fault\_injection\_probability

백업 또는 복원 중 Keeper 요청이 실패할 대략적인 확률입니다. 유효한 값 범위는 인터벌 \[0.0f, 1.0f]입니다.

## backup\_restore\_keeper\_fault\_injection\_seed

0 - 랜덤 시드, 그 밖에는 설정값

## backup\_restore\_keeper\_max\_retries

BACKUP 또는 RESTORE 작업 도중 \[Zoo]Keeper 작업에 대해 허용되는 최대 재시도 횟수입니다. 일시적인 \[Zoo]Keeper 장애로 인해 전체 작업이 실패하지 않도록 충분히 크게 설정해야 합니다.

## backup\_restore\_keeper\_max\_retries\_while\_handling\_error

BACKUP ON CLUSTER 또는 RESTORE ON CLUSTER 작업에서 오류를 처리하는 동안 수행되는 \[Zoo]Keeper 작업의 최대 재시도 횟수입니다.

## backup\_restore\_keeper\_max\_retries\_while\_initializing

BACKUP ON CLUSTER 또는 RESTORE ON CLUSTER 작업 초기화 중 \[Zoo]Keeper 작업의 최대 재시도 횟수입니다.

## backup\_restore\_keeper\_retry\_initial\_backoff\_ms

backup 또는 복원 중 \[Zoo]Keeper 작업에 대한 초기 백오프 타임아웃

## backup\_restore\_keeper\_retry\_max\_backoff\_ms

백업 또는 복원 중 \[Zoo]Keeper 작업의 최대 백오프 타임아웃 Cloud 기본값: `60000`.

## backup\_restore\_keeper\_value\_max\_size

백업 중 \[Zoo]Keeper 노드에 저장되는 데이터의 최대 크기

## backup\_restore\_s3\_retry\_attempts

Aws::Client::RetryStrategy용 설정입니다. Aws::Client는 자체적으로 재시도하며, 0은 재시도를 수행하지 않음을 의미합니다. 이 설정은 백업/복원에만 적용됩니다.

## backup\_restore\_s3\_retry\_initial\_backoff\_ms

백업 및 복원 중 첫 번째 재시도 전에 적용되는 초기 백오프 지연 시간(밀리초)입니다. 이후 각 재시도마다 지연 시간이 지수적으로 증가하며, 최대값은 `backup_restore_s3_retry_max_backoff_ms`로 지정됩니다.

## backup\_restore\_s3\_retry\_jitter\_factor

백업 및 복원 작업 중 Aws::Client::RetryStrategy의 재시도 백오프 지연에 적용되는 지터 계수입니다. 계산된 백오프 지연은 \[1.0, 1.0 + jitter] 범위의 임의 계수와 곱해지며, 최대 `backup_restore_s3_retry_max_backoff_ms`까지 적용됩니다. 값은 \[0.0, 1.0] 인터벌에 있어야 합니다

## backup\_restore\_s3\_retry\_max\_backoff\_ms

백업 및 복원 작업에서 재시도 간 최대 지연 시간(밀리초)입니다.

## backup\_slow\_all\_threads\_after\_retryable\_s3\_error

`true`로 설정하면 동일한 백업 엔드포인트로 S3 요청을 실행하는 모든 스레드의 속도가 'Sleep Down'과 같은 재시도 가능한 S3 오류가 단 하나의 S3 요청에서라도 발생한 후 늦춰집니다. `false`로 설정하면 각 스레드는 다른 스레드와 독립적으로 S3 요청의 백오프를 처리합니다.

## cache\_warmer\_threads

ClickHouse Cloud에서만 적용됩니다. [cache\_populated\_by\_fetch](/ko/reference/settings/merge-tree-settings#cache_populated_by_fetch)가 활성화된 경우, 새 데이터 파트를 파일 시스템 캐시에 선제적으로 다운로드하는 백그라운드 스레드 수입니다. 비활성화하려면 0으로 설정하십시오.

## calculate\_text\_stack\_trace

쿼리 실행 중 예외가 발생하면 텍스트 스택 트레이스를 계산합니다. 기본값입니다. 이를 위해 심볼 조회가 필요하므로, 잘못된 쿼리가 대량으로 실행되면 퍼징 테스트가 느려질 수 있습니다. 일반적으로는 이 옵션을 비활성화하지 않는 것이 좋습니다.

## cancel\_http\_readonly\_queries\_on\_client\_close

클라이언트가 응답을 기다리지 않은 채 연결을 닫으면 HTTP 읽기 전용 쿼리(예: `SELECT`)를 취소합니다. Cloud 기본값: `1`.

## cast\_ipv4\_ipv6\_default\_on\_conversion\_error

IPv4로 CAST하는 연산자, IPv6 유형으로 CAST하는 연산자, 그리고 toIPv4, toIPv6 함수는 변환 오류가 발생하면 예외를 발생시키는 대신 기본값을 반환합니다.

## cast\_keep\_nullable

[CAST](/ko/reference/functions/regular-functions/type-conversion-functions#CAST) 연산에서 `Nullable` 데이터 타입을 유지할지 여부를 설정합니다. 이 설정이 활성화되어 있고 `CAST` 함수의 인수가 `Nullable`이면 결과도 `Nullable` 타입으로 변환됩니다. 이 설정이 비활성화되면 결과는 항상 지정된 대상 타입 그대로 반환됩니다. Possible values: * 0 — `CAST` 결과는 지정된 대상 타입 그대로 반환됩니다. * 1 — 인수 타입이 `Nullable`이면 `CAST` 결과는 `Nullable(DestinationDataType)`으로 변환됩니다. **예시** 다음 쿼리는 정확히 대상 데이터 타입으로 결과를 반환합니다. ```sql theme={null} SET cast_keep_nullable = 0; SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x); ``` 결과: ```text theme={null} ┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐ │ 0 │ Int32 │ └───┴───────────────────────────────────────────────────┘ ``` 다음 쿼리를 실행하면 대상 데이터 타입에 `Nullable` 수정자가 적용된 결과가 반환됩니다: ```sql theme={null} SET cast_keep_nullable = 1; SELECT CAST(toNullable(toInt32(0)) AS Int32) as x, toTypeName(x); ``` 결과: ```text theme={null} ┌─x─┬─toTypeName(CAST(toNullable(toInt32(0)), 'Int32'))─┐ │ 0 │ Nullable(Int32) │ └───┴───────────────────────────────────────────────────┘ ``` **관련 항목** * [CAST](/ko/reference/functions/regular-functions/type-conversion-functions#CAST) 함수

## cast\_string\_to\_date\_time\_mode

String에서 캐스트할 때 날짜 및 시간의 텍스트 표현을 해석할 파서를 선택할 수 있습니다. 가능한 값: * `'best_effort'` — 확장 파싱을 활성화합니다. ClickHouse는 기본 `YYYY-MM-DD HH:MM:SS` 포맷과 모든 [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) 날짜 및 시간 포맷을 파싱할 수 있습니다. 예를 들어 `'2018-06-08T01:02:03.000Z'`가 있습니다. * `'best_effort_us'` — `best_effort`와 유사합니다([parseDateTimeBestEffortUS](/ko/reference/functions/regular-functions/type-conversion-functions#parseDateTimeBestEffortUS)에서 차이점을 확인하십시오) * `'basic'` — 기본 파서를 사용합니다. ClickHouse는 기본 `YYYY-MM-DD HH:MM:SS` 또는 `YYYY-MM-DD` 포맷만 파싱할 수 있습니다. 예를 들어 `2019-08-20 10:18:56` 또는 `2019-08-20`가 있습니다. 관련 항목: * [DateTime 데이터 타입.](/ko/reference/data-types/datetime) * [날짜 및 시간을 다루는 함수.](/ko/reference/functions/regular-functions/date-time-functions)

## cast\_string\_to\_dynamic\_use\_inference

String을 Dynamic으로 변환할 때 타입 추론을 사용합니다

## cast\_string\_to\_variant\_use\_inference

String에서 Variant로 변환할 때 타입 추론을 사용합니다.

## check\_named\_collection\_dependencies

DROP NAMED COLLECTION이 이를 참조하는 테이블에 문제를 일으키지 않는지 확인합니다

## check\_query\_single\_value\_result

`MergeTree` 계열 엔진에서 [CHECK TABLE](/ko/reference/statements/check-table) 쿼리 결과에 표시되는 세부 수준을 정의합니다. 가능한 값: * 0 — 쿼리에서 테이블의 각 개별 데이터 파트에 대한 검사 상태를 표시합니다. * 1 — 쿼리에서 테이블 전체의 검사 상태를 표시합니다.

## check\_referential\_table\_dependencies

DDL 쿼리(DROP TABLE 또는 RENAME 등)가 참조 의존성을 손상시키지 않는지 확인합니다

## check\_table\_dependencies

DDL 쿼리(DROP TABLE 또는 RENAME 등)로 인해 의존 관계가 깨지지 않는지 확인합니다

## checksum\_on\_read

읽을 때 체크섬을 검증합니다. 기본적으로 활성화되어 있으며, 프로덕션 환경에서는 항상 활성화해 두어야 합니다. 이 설정을 비활성화해도 어떤 이점도 기대할 수 없습니다. 이 설정은 실험과 벤치마크에만 사용해야 합니다. 이 설정은 MergeTree 엔진 계열의 테이블에만 적용됩니다. 다른 테이블 엔진에서는 물론, 네트워크를 통해 데이터를 수신할 때도 체크섬이 항상 검증됩니다.

## cloud\_mode

Cloud 모드 Cloud 기본값: `1`.

## cloud\_mode\_database\_engine

Cloud에서 허용되는 데이터베이스 엔진입니다. 1은 DDL을 재작성해 복제된 데이터베이스를 사용하고, 2는 DDL을 재작성해 Shared 데이터베이스를 사용합니다. Cloud 기본값: `2`.

## cloud\_mode\_engine

Cloud에서 허용되는 엔진 계열입니다. * 0 - 모두 허용 * 1 - DDLs를 \*ReplicatedMergeTree를 사용하도록 재작성 * 2 - DDLs를 SharedMergeTree를 사용하도록 재작성 * 3 - 원격 디스크를 명시적으로 지정한 경우를 제외하고 DDLs를 SharedMergeTree를 사용하도록 재작성 * 4 - 3과 동일하며, 추가로 Distributed 대신 Alias를 사용합니다(Alias table은 Distributed table의 대상 테이블을 가리키므로 해당 로컬 테이블을 사용합니다) public part를 최소화하기 위한 UInt64 Cloud 기본값: `2`.

## cluster\_for\_parallel\_replicas

현재 서버가 속한 세그먼트의 클러스터 Cloud 기본값: `default`.

## cluster\_function\_process\_archive\_on\_multiple\_nodes

`true`로 설정하면 cluster 함수에서 아카이브를 처리하는 성능이 향상됩니다. 이전 버전에서 아카이브와 함께 cluster 함수를 사용하는 경우, 호환성을 유지하고 25.7+로 업그레이드할 때 오류를 방지하려면 `false`로 설정해야 합니다.

## cluster\_table\_function\_buckets\_batch\_size

`bucket` 분할 세분화 수준을 사용하는 cluster 테이블 함수에서 작업의 분산 처리에 사용되는 배치의 대략적인 크기(바이트 단위)를 정의합니다. 시스템은 최소 이 크기에 도달할 때까지 데이터를 누적합니다. 실제 크기는 데이터 경계에 맞추기 위해 약간 더 커질 수 있습니다.

## cluster\_table\_function\_split\_granularity

CLUSTER TABLE FUNCTION을 실행할 때 데이터를 작업으로 어떻게 나눌지 제어합니다. 이 설정은 클러스터 전체에 작업을 분산할 때의 세분화 수준을 정의합니다: * `file` — 각 작업이 파일 전체를 처리합니다. * `bucket` — 파일 내부의 데이터 블록별로 작업을 생성합니다(예: Parquet row group). 소수의 대용량 파일을 처리할 때는 `bucket`과 같이 더 세밀한 세분화 수준을 선택하면 병렬성을 높일 수 있습니다. 예를 들어 Parquet 파일에 여러 row group이 포함된 경우, `bucket` 세분화 수준을 사용하면 각 group을 서로 다른 워커가 독립적으로 처리할 수 있습니다.

## collect\_hash\_table\_stats\_during\_aggregation

메모리 할당을 최적화하기 위해 해시 테이블 통계를 수집하도록 설정합니다

## collect\_hash\_table\_stats\_during\_joins

메모리 할당을 최적화하기 위해 해시 테이블 통계를 수집하도록 합니다.

## 호환성

`compatibility` 설정을 사용하면, 설정에 지정한 이전 버전의 ClickHouse 기본 설정을 ClickHouse에서 사용합니다. 일부 설정이 기본값이 아닌 값으로 지정되어 있으면 해당 설정값은 그대로 유지됩니다(`compatibility` 설정은 수정되지 않은 설정에만 적용됩니다). 이 설정에는 `22.3`, `22.8`과 같은 ClickHouse 버전 번호를 문자열로 지정합니다. 빈 값은 이 설정이 비활성화되었음을 의미합니다. 기본값은 비활성화입니다. ClickHouse Cloud에서는 서비스 수준의 기본 호환성 설정을 ClickHouse Cloud Support에서 설정해야 합니다. 설정이 필요하면 [지원 케이스를 제출하세요](https://clickhouse.cloud/support). 하지만 호환성 설정은 세션에서 `SET compatibility = '22.3'`를 사용하거나 쿼리에서 `SETTINGS compatibility = '22.3'`를 사용하는 등 표준 ClickHouse 설정 메커니즘을 통해 사용자, 역할(Role), 프로필(profile), 쿼리 또는 세션(session) 수준에서 재정의할 수 있습니다.

## compatibility\_ignore\_auto\_increment\_in\_create\_table

true이면 컬럼 선언에서 AUTO\_INCREMENT 키워드를 무시하고, 그렇지 않으면 오류를 반환합니다. MySQL에서 마이그레이션을 더 쉽게 수행할 수 있습니다.

## compatibility\_ignore\_collation\_in\_create\_table

CREATE TABLE에서 Collation을 무시하는 호환성 설정

## compatibility\_s3\_presigned\_url\_query\_in\_path

호환성: 활성화하면 사전 서명된 URL 쿼리 매개변수(예: X-Amz-\*)를 S3 key에 포함합니다(기존 동작). 따라서 '?'는 경로에서 와일드카드로 동작합니다. 비활성화하면(기본값) 사전 서명된 URL 쿼리 매개변수는 URL 쿼리에 유지되어 '?'가 와일드카드로 해석되지 않도록 합니다.

## compile\_aggregate\_expressions

집계 함수를 네이티브 코드로 JIT 컴파일할지 여부를 설정합니다. 이 설정을 활성화하면 성능이 향상될 수 있습니다. 가능한 값: * 0 — JIT 컴파일 없이 집계를 수행합니다. * 1 — JIT 컴파일을 사용해 집계를 수행합니다. **관련 항목** * [min\_count\_to\_compile\_aggregate\_expression](#min_count_to_compile_aggregate_expression)

## compile\_expressions

일부 스칼라 함수와 연산자를 네이티브 코드로 컴파일합니다.

## compile\_sort\_description

정렬 설명을 네이티브 코드로 컴파일합니다.

## connect\_timeout

레플리카가 없으면 연결 타임아웃이 적용됩니다.

## connect\_timeout\_with\_failover\_ms

cluster 정의에서 'shard' 및 'replica' 섹션을 사용하는 경우, 분산 테이블 엔진이 원격 서버에 연결할 때 적용되는 밀리초 단위의 timeout입니다. 연결에 실패하면 여러 레플리카에 대해 연결을 여러 번 시도합니다.

## connect\_timeout\_with\_failover\_secure\_ms

보안 연결에서 첫 번째 정상 레플리카를 선택하기 위한 연결 타임아웃입니다.

## connection\_pool\_max\_wait\_ms

연결 풀(connection pool)이 가득 찼을 때 연결을 위해 밀리초 단위로 대기하는 시간입니다. 가능한 값: * 양의 정수입니다. * 0 — 무한 타임아웃입니다.

## connections\_with\_failover\_max\_tries

분산 테이블 엔진에서 각 레플리카에 대해 허용되는 최대 연결 시도 횟수입니다.

## convert\_query\_to\_cnf

`true`로 설정하면 `SELECT` 쿼리가 논리곱 정규형(CNF)으로 변환됩니다. 쿼리를 CNF로 재작성하면 더 빠르게 실행될 수 있는 경우가 있습니다(자세한 설명은 이 [GitHub issue](https://github.com/ClickHouse/ClickHouse/issues/11749)를 참조하십시오). 예시로, 다음 `SELECT` 쿼리는 수정되지 않습니다(기본 동작). ```sql theme={null} EXPLAIN SYNTAX SELECT * FROM ( SELECT number AS x FROM numbers(20) ) AS a WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) SETTINGS convert_query_to_cnf = false; ``` 결과는 다음과 같습니다: ```response theme={null} ┌─explain────────────────────────────────────────────────────────┐ │ SELECT x │ │ FROM │ │ ( │ │ SELECT number AS x │ │ FROM numbers(20) │ │ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │ │ ) AS a │ │ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │ │ SETTINGS convert_query_to_cnf = 0 │ └────────────────────────────────────────────────────────────────┘ ``` `convert_query_to_cnf`를 `true`로 설정한 뒤 어떤 점이 달라지는지 살펴보겠습니다: ```sql theme={null} EXPLAIN SYNTAX SELECT * FROM ( SELECT number AS x FROM numbers(20) ) AS a WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) SETTINGS convert_query_to_cnf = true; ``` `WHERE` 절은 CNF로 다시 작성되지만, 결과 집합은 완전히 동일합니다. 즉, Boolean 논리는 변경되지 않습니다: ```response theme={null} ┌─explain───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ │ SELECT x │ │ FROM │ │ ( │ │ SELECT number AS x │ │ FROM numbers(20) │ │ WHERE ((x <= 15) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x >= 10) OR (x >= 1)) │ │ ) AS a │ │ WHERE ((x >= 10) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x <= 15) OR (x <= 5)) │ │ SETTINGS convert_query_to_cnf = 1 │ └───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ ``` 가능한 값: true, false

## correlated\_subqueries\_default\_join\_kind

상관관계가 제거된 쿼리 계획에서 사용할 조인 종류를 제어합니다. 기본값은 `right`이며, 이는 상관관계가 제거된 계획에 오른쪽에 서브쿼리 입력이 있는 RIGHT JOIN이 포함된다는 의미입니다. 가능한 값: * `left` - 상관관계 제거 과정에서 LEFT JOIN이 생성되며 입력 테이블은 왼쪽에 배치됩니다. * `right` - 상관관계 제거 과정에서 RIGHT JOIN이 생성되며 입력 테이블은 오른쪽에 배치됩니다.

## correlated\_subqueries\_substitute\_equivalent\_expressions

CROSS JOIN을 생성하는 대신 필터 표현식을 사용해 동등한 표현식을 추론하고 이를 대체합니다.

## correlated\_subqueries\_use\_in\_memory\_buffer

반복 평가를 방지하기 위해 상관 서브쿼리 입력에 인메모리 버퍼를 사용합니다.

## count\_distinct\_implementation

[COUNT(DISTINCT ...)](/ko/reference/functions/aggregate-functions/count) 구문을 실행할 때 사용할 `uniq*` 함수를 지정합니다. 가능한 값: * [uniq](/ko/reference/functions/aggregate-functions/uniq) * [uniqCombined](/ko/reference/functions/aggregate-functions/uniqCombined) * [uniqCombined64](/ko/reference/functions/aggregate-functions/uniqCombined64) * [uniqHLL12](/ko/reference/functions/aggregate-functions/uniqHLL12) * [uniqExact](/ko/reference/functions/aggregate-functions/uniqExact)

## count\_distinct\_optimization

count distinct를 group by 서브쿼리로 재작성합니다

## count\_matches\_stop\_at\_empty\_match

`countMatches` 함수에서 패턴이 길이가 0인 문자열과 일치하면 개수 계산을 중지합니다.

## create\_if\_not\_exists

기본적으로 `CREATE` 문에 `IF NOT EXISTS`를 적용합니다. 이 설정 또는 `IF NOT EXISTS`를 지정하고 해당 이름의 테이블이 이미 존재하는 경우 예외가 발생하지 않습니다.

## create\_index\_ignore\_unique

CREATE UNIQUE INDEX에서 UNIQUE 키워드를 무시합니다. SQL 호환성 테스트용 설정입니다.

## create\_replicated\_merge\_tree\_fault\_injection\_probability

ZooKeeper에 메타데이터를 생성한 후 테이블 생성 과정에서 장애 주입이 발생할 확률

## create\_table\_empty\_primary\_key\_by\_default

ORDER BY와 PRIMARY KEY를 지정하지 않은 경우 빈 프라이머리 키를 가진 \*MergeTree 테이블을 생성할 수 있도록 합니다

## cross\_join\_min\_bytes\_to\_compress

CROSS JOIN에서 압축할 블록의 최소 크기입니다. 값이 0이면 이 임계값이 비활성화됩니다. 이 블록은 두 임계값(행 수 기준 또는 바이트 기준) 중 하나에 도달하면 압축됩니다.

## cross\_join\_min\_rows\_to\_compress

CROSS JOIN에서 block을 압축하기 위한 최소 행 수입니다. 값이 0이면 이 임계값을 비활성화한다는 의미입니다. 이 block은 두 임계값(행 수 기준 또는 바이트 기준) 중 하나에 도달하면 압축됩니다.

## cross\_to\_inner\_join\_rewrite

WHERE 절에 조인 표현식이 있으면 comma/cross join 대신 inner join을 사용합니다. 값: 0 - 재작성하지 않음, 1 - comma/cross join에 가능하면 적용, 2 - 모든 comma join을 강제로 재작성, cross - 가능하면 적용

## data\_type\_default\_nullable

컬럼 정의에서 명시적 수정자 [NULL or NOT NULL](/ko/reference/statements/create/table#null-or-not-null-modifiers)를 지정하지 않은 데이터 타입을 [널 허용(Nullable)](/ko/reference/data-types/nullable)으로 처리합니다. 가능한 값: * 1 — 컬럼 정의의 데이터 타입이 기본적으로 `Nullable`로 설정됩니다. * 0 — 컬럼 정의의 데이터 타입이 기본적으로 `Nullable`이 아닌 것으로 설정됩니다.

## database\_atomic\_wait\_for\_drop\_and\_detach\_synchronously

모든 `DROP` 및 `DETACH` 쿼리에 `SYNC` 수정자를 추가합니다. 가능한 값: * 0 — 쿼리가 지연되어 실행됩니다. * 1 — 쿼리가 지연 없이 실행됩니다.

## database\_datalake\_require\_metadata\_access

데이터베이스 엔진 DataLakeCatalog에서 테이블 메타데이터를 가져올 권한이 없을 때 오류를 발생시킬지 여부를 지정합니다.

## database\_replicated\_allow\_explicit\_uuid

0 - 복제된 데이터베이스의 테이블에 UUID를 명시적으로 지정할 수 없습니다. 1 - 허용합니다. 2 - 허용하지만 지정된 UUID는 무시하고 대신 임의의 UUID를 생성합니다.

## database\_replicated\_allow\_heavy\_create