> ## 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.

# max_* 서버 설정

> max_* 생성 그룹에 포함된 ClickHouse 서버 설정입니다.

이 설정은 ClickHouse 서버 구성에 사용되며 ClickHouse 소스 코드에서 자동으로 생성되었습니다.

## max\_active\_parts\_loading\_thread\_pool\_size

유형 UInt64 기본값 64 재시작 없이 변경 가능 Yes시작 시 활성 데이터 파트 집합(즉, 활성 상태의 파트)을 로드하는 데 사용되는 스레드 수입니다.

## max\_authentication\_methods\_per\_user

유형

UInt64

기본값

100

재시작 없이 변경 가능

No

사용자를 생성하거나 변경할 때 설정할 수 있는 최대 인증 메서드 수입니다.
이 설정을 변경해도 기존 사용자에게는 영향을 주지 않습니다. 이 설정에서 지정한 한도를 초과하면 인증 관련 CREATE/ALTER 쿼리가 실패합니다.
인증과 관련 없는 CREATE/ALTER 쿼리는 성공합니다.

> [!NOTE]
>
> 값이 `0`이면 무제한을 의미합니다.

## max\_backup\_bandwidth\_for\_server

유형 UInt64 기본값 0 재시작 없이 변경 가능 No서버의 모든 백업에 대한 초당 바이트 단위의 최대 읽기 속도입니다. 0은 제한 없음을 의미합니다.

## max\_build\_vector\_similarity\_index\_thread\_pool\_size

유형

UInt64

기본값

16

재시작 없이 변경 가능

No

vector index를 빌드할 때 사용할 최대 스레드 수입니다.

> [!NOTE]
>
> 값이 `0`이면 모든 코어를 사용함을 의미합니다.

## max\_connections

유형 Int32 기본값 4096 재시작 없이 변경 가능 No서버의 최대 연결 수입니다.

## max\_entries\_for\_hash\_table\_stats

유형 UInt64 기본값 10000 재시작 없이 변경 가능 No집계 중 수집되는 해시 테이블 통계에 허용되는 최대 항목 수

## max\_fetch\_partition\_thread\_pool\_size

유형 UInt64 기본값 64 재시작 없이 변경 가능 YesALTER TABLE FETCH PARTITION에 사용할 스레드 수입니다.

## max\_held\_snapshots

유형 UInt64 기본값 0 재시작 없이 변경 가능 No동시에 보관할 수 있는 경량 스냅샷의 최대 개수입니다. 0은 무제한을 의미합니다. 스냅샷 수가 이 한도에 도달한 상태에서 새 스냅샷을 생성하려고 하면 예외가 발생합니다.

## max\_http\_index\_page\_size

유형

UInt64

기본값

10485760

재시작 없이 변경 가능

No

HTTP를 통해 디렉터리 목록을 조회할 때 사용되는 HTTP 인덱스 페이지 응답의 최대 크기입니다.
응답이 이 제한을 초과하면 쿼리가 오류와 함께 실패합니다.

기본값: `10485760` (10 MiB).

## max\_iceberg\_manifest\_decode\_thread\_pool\_free\_size

유형

UInt64

기본값

0

재시작 없이 변경 가능

Yes

Iceberg 데이터 manifest 파일을 디코딩하는 스레드 풀에 유지할 유휴 대기 스레드의 최대 개수입니다.

## max\_iceberg\_manifest\_decode\_thread\_pool\_size

유형

UInt64

기본값

100

재시작 없이 변경 가능

Yes

Iceberg 데이터 manifest 파일을 디코딩하는 데 사용할 최대 총 스레드 수입니다.

이 풀은 의도적으로 IO 풀과 분리되어 있습니다. 디코딩 작업은 자신이 생성한 항목을 쿼리가 소비할 때까지 블록될 수 있는 반면, delete manifest 디코딩은 어떤 항목이 소비되기 전에 IO 풀에 있는 자신의 작업이 끝나기를 기다립니다. 따라서 하나의 풀을 공유하면 교착 상태가 발생할 수 있습니다.

## max\_keep\_alive\_requests

유형

UInt64

기본값

10000

재시작 없이 변경 가능

No

단일 keep-alive 연결을 통해 처리할 수 있는 최대 요청 수입니다. 이 값을 초과하면 ClickHouse 서버가 연결을 닫습니다.

**예시**

```xml theme={null}
<max_keep_alive_requests>10</max_keep_alive_requests>
```

## max\_materialized\_views\_count\_for\_table

유형

UInt64

기본값

0

재시작 없이 변경 가능

No

테이블에 연결된 materialized view 수를 제한합니다.

> [!NOTE]
>
> 여기서는 직접 종속된 뷰만 고려하며, 한 뷰 위에 다른 뷰를 생성하는 경우는 포함되지 않습니다.

## max\_merges\_bandwidth\_for\_server

유형 UInt64 기본값 0 재시작 없이 변경 가능 Noserver의 모든 머지 작업에 대한 초당 최대 읽기 속도(바이트)입니다. 0은 무제한을 의미합니다.

## max\_mutations\_bandwidth\_for\_server

유형 UInt64 기본값 0 재시작 없이 변경 가능 Noserver의 모든 뮤테이션에 적용되는 최대 읽기 속도이며, 초당 바이트 수로 지정됩니다. 0은 무제한을 의미합니다.

## max\_open\_files

유형

UInt64

기본값

0

재시작 없이 변경 가능

No

동시에 열 수 있는 파일의 최대 개수입니다.

> [!NOTE]
>
> getrlimit() 함수가 잘못된 값을 반환하므로 macOS에서는 이 옵션을 사용하는 것이 좋습니다.

## max\_os\_cpu\_wait\_time\_ratio\_to\_drop\_connection

유형

Float

기본값

0

재시작 없이 변경 가능

Yes

연결을 끊을지 판단할 때 고려하는 OS CPU 대기 시간(OSCPUWaitMicroseconds 메트릭)과 사용 중 시간(OSCPUVirtualTimeMicroseconds 메트릭) 사이의 최대 비율입니다. 확률 계산에는 최소 비율과 최대 비율 사이의 선형 보간을 사용하며, 이 지점에서 확률은 1입니다.
자세한 내용은 [서버 CPU 과부하 시 동작 제어](https://clickhouse.com/docs/ko/concepts/features/configuration/settings/server-overload.md)를 참조하십시오.

## max\_outdated\_parts\_loading\_thread\_pool\_size

유형 UInt64 기본값 32 재시작 없이 변경 가능 Yes시작 시 비활성 데이터 파트 집합(Outdated 상태의 파트)을 로드하는 스레드 수입니다.

## max\_part\_num\_to\_warn

유형

UInt64

기본값

100000

재시작 없이 변경 가능

Yes

활성 파트 수가 지정된 값을 초과하면 ClickHouse 서버가 `system.warnings` 테이블에 경고 메시지를 추가합니다.

**예시**

```xml theme={null}
<max_part_num_to_warn>400</max_part_num_to_warn>
```

## max\_partition\_size\_to\_drop

유형

UInt64

기본값

50000000000

재시작 없이 변경 가능

Yes

파티션 삭제 제한입니다.

[MergeTree](https://clickhouse.com/docs/ko/reference/engines/table-engines/mergetree-family/mergetree.md) 테이블의 크기가 [`max_partition_size_to_drop`](https://clickhouse.com/docs/ko/reference/settings/server-settings/settings/max#max_partition_size_to_drop) 값을 초과하면(바이트 단위) [DROP PARTITION](https://clickhouse.com/docs/ko/reference/statements/alter/partition.md#drop-partitionpart) 쿼리로 파티션을 삭제할 수 없습니다.
이 설정은 적용할 때 ClickHouse 서버를 재시작할 필요가 없습니다. 제한을 비활성화하는 또 다른 방법은 `<clickhouse-path>/flags/force_drop_table` 파일을 생성하는 것입니다.

> [!NOTE]
>
> 값 `0`은 아무 제한 없이 파티션을 삭제할 수 있음을 의미합니다.
>
> 이 제한은 drop table 및 truncate table에는 적용되지 않습니다. [max\_table\_size\_to\_drop](https://clickhouse.com/docs/ko/reference/settings/session-settings/max.md#max_table_size_to_drop)를 참조하십시오.

**예시**

```xml theme={null}
<max_partition_size_to_drop>0</max_partition_size_to_drop>
```

## max\_parts\_cleaning\_thread\_pool\_size

유형 UInt64 기본값 128 재시작 없이 변경 가능 Yes비활성 데이터 파트를 동시에 제거하는 데 사용하는 스레드 수입니다.

## max\_per\_cpu\_untracked\_memory

유형

UInt64

기본값

8388608

재시작 없이 변경 가능

Yes

한 CPU에서 실행되는 모든 스레드가 메모리 추적기(memory tracker)에 플러시되기 전에 동시에 보유할 수 있는 미추적 메모리의 상한값(바이트 단위)입니다. `max_untracked_memory`가 단일 스레드의 한계를 정하는 반면, 이 설정은 CPU별 총량을 제한하므로 여러 스레드가 스레드별 허용량만큼 누적하여 서버 전체에서 큰 오버커밋이 발생하는 것을 방지합니다. 따라서 전체 미추적 메모리는 대략 `number_of_cpus * max_per_cpu_untracked_memory`로 제한됩니다. 값이 `0`이면 CPU별 제한이 비활성화되며(스레드별 `max_untracked_memory`만 적용됨), Linux에서만 사용할 수 있습니다.

## max\_session\_timeout

세션 타임아웃의 최댓값(초)입니다.

예시:

```xml theme={null}
<max_session_timeout>3600</max_session_timeout>
```

## max\_temporary\_data\_on\_disk\_size

유형

UInt64

기본값

0

재시작 없이 변경 가능

No

외부 집계, 조인 또는 정렬에 사용할 수 있는 디스크 저장 공간의 최대 크기입니다.
이 한도를 초과하는 쿼리는 예외를 발생시키며 실패합니다.

> [!NOTE]
>
> 값이 `0`이면 무제한을 의미합니다.

관련 항목:

* [`max_temporary_data_on_disk_size_for_user`](https://clickhouse.com/docs/ko/reference/settings/session-settings/max-temporary#max_temporary_data_on_disk_size_for_user)
* [`max_temporary_data_on_disk_size_for_query`](https://clickhouse.com/docs/ko/reference/settings/session-settings/max-temporary#max_temporary_data_on_disk_size_for_query)

## max\_unexpected\_parts\_loading\_thread\_pool\_size

유형 UInt64 기본값 8 재시작 없이 변경 가능 No시작할 때 비활성 데이터 파트 집합(Unexpected 파트)을 로드하는 데 사용하는 스레드 수입니다.

## max\_waiting\_queries

유형

UInt64

기본값

0

재시작 없이 변경 가능

Yes

동시에 대기할 수 있는 전체 쿼리 수의 한도입니다.
필요한 테이블이 비동기로 로드되는 동안에는 대기 중인 쿼리의 실행이 차단됩니다([`async_load_databases`](https://clickhouse.com/docs/ko/reference/settings/server-settings/settings/async-load#async_load_databases) 참조).

> [!NOTE]
>
> 다음 설정으로 제어되는 한도를 확인할 때는 대기 중인 쿼리를 계산에 포함하지 않습니다:
>
> * [`max_concurrent_queries`](https://clickhouse.com/docs/ko/reference/settings/server-settings/settings/max-concurrent#max_concurrent_queries)
> * [`max_concurrent_insert_queries`](https://clickhouse.com/docs/ko/reference/settings/server-settings/settings/max-concurrent#max_concurrent_insert_queries)
> * [`max_concurrent_select_queries`](https://clickhouse.com/docs/ko/reference/settings/server-settings/settings/max-concurrent#max_concurrent_select_queries)
> * [`max_concurrent_queries_for_user`](https://clickhouse.com/docs/ko/reference/settings/session-settings/max-concurrent#max_concurrent_queries_for_user)
> * [`max_concurrent_queries_for_all_users`](https://clickhouse.com/docs/ko/reference/settings/session-settings/max-concurrent#max_concurrent_queries_for_all_users)
>
> 이 보정은 server 시작 직후 이러한 한도에 도달하는 일을 방지하기 위해 적용됩니다.

> [!NOTE]
>
> `0` 값(기본값)은 한도가 없음을 의미합니다.
>
> 이 설정은 런타임에 수정할 수 있으며 즉시 적용됩니다. 이미 실행 중인 쿼리에는 영향을 주지 않습니다.

## max\_zookeeper\_pooled\_connections

유형

UInt64

기본값

0

재시작 없이 변경 가능

No

공유 풀에서 ZooKeeper 클러스터당 지연 초기화되는 ZooKeeper 세션의 최대 개수입니다.

값이 `0`이면 풀링된 연결이 비활성화되며 단일 세션을 계속 사용합니다.
