max_active_parts_loading_thread_pool_size
시작 시 활성 데이터 파트 집합(즉, 활성 상태의 파트)을 로드하는 데 사용되는 스레드 수입니다.max_authentication_methods_per_user
사용자를 생성하거나 변경할 때 설정할 수 있는 최대 인증 메서드 수입니다. 이 설정을 변경해도 기존 사용자에게는 영향을 주지 않습니다. 이 설정에서 지정한 한도를 초과하면 인증 관련 CREATE/ALTER 쿼리가 실패합니다. 인증과 관련 없는 CREATE/ALTER 쿼리는 성공합니다.값이
0이면 무제한을 의미합니다.max_backup_bandwidth_for_server
서버의 모든 백업에 대한 초당 바이트 단위의 최대 읽기 속도입니다. 0은 제한 없음을 의미합니다.max_build_vector_similarity_index_thread_pool_size
vector index를 빌드할 때 사용할 최대 스레드 수입니다.값이
0이면 모든 코어를 사용함을 의미합니다.max_connections
서버의 최대 연결 수입니다.max_entries_for_hash_table_stats
집계 중 수집되는 해시 테이블 통계에 허용되는 최대 항목 수max_fetch_partition_thread_pool_size
ALTER TABLE FETCH PARTITION에 사용할 스레드 수입니다.max_held_snapshots
동시에 보관할 수 있는 경량 스냅샷의 최대 개수입니다. 0은 무제한을 의미합니다. 스냅샷 수가 이 한도에 도달한 상태에서 새 스냅샷을 생성하려고 하면 예외가 발생합니다.max_http_index_page_size
HTTP를 통해 디렉터리 목록을 조회할 때 사용되는 HTTP 인덱스 페이지 응답의 최대 크기입니다. 응답이 이 제한을 초과하면 쿼리가 오류와 함께 실패합니다. 기본값:10485760 (10 MiB).
max_iceberg_manifest_decode_thread_pool_free_size
Iceberg 데이터 manifest 파일을 디코딩하는 스레드 풀에 유지할 유휴 대기 스레드의 최대 개수입니다.max_iceberg_manifest_decode_thread_pool_size
Iceberg 데이터 manifest 파일을 디코딩하는 데 사용할 최대 총 스레드 수입니다. 이 풀은 의도적으로 IO 풀과 분리되어 있습니다. 디코딩 작업은 자신이 생성한 항목을 쿼리가 소비할 때까지 블록될 수 있는 반면, delete manifest 디코딩은 어떤 항목이 소비되기 전에 IO 풀에 있는 자신의 작업이 끝나기를 기다립니다. 따라서 하나의 풀을 공유하면 교착 상태가 발생할 수 있습니다.max_keep_alive_requests
단일 keep-alive 연결을 통해 처리할 수 있는 최대 요청 수입니다. 이 값을 초과하면 ClickHouse 서버가 연결을 닫습니다. 예시max_materialized_views_count_for_table
테이블에 연결된 materialized view 수를 제한합니다.여기서는 직접 종속된 뷰만 고려하며, 한 뷰 위에 다른 뷰를 생성하는 경우는 포함되지 않습니다.
max_merges_bandwidth_for_server
server의 모든 머지 작업에 대한 초당 최대 읽기 속도(바이트)입니다. 0은 무제한을 의미합니다.max_mutations_bandwidth_for_server
server의 모든 뮤테이션에 적용되는 최대 읽기 속도이며, 초당 바이트 수로 지정됩니다. 0은 무제한을 의미합니다.max_open_files
동시에 열 수 있는 파일의 최대 개수입니다.getrlimit() 함수가 잘못된 값을 반환하므로 macOS에서는 이 옵션을 사용하는 것이 좋습니다.
max_os_cpu_wait_time_ratio_to_drop_connection
연결을 끊을지 판단할 때 고려하는 OS CPU 대기 시간(OSCPUWaitMicroseconds 메트릭)과 사용 중 시간(OSCPUVirtualTimeMicroseconds 메트릭) 사이의 최대 비율입니다. 확률 계산에는 최소 비율과 최대 비율 사이의 선형 보간을 사용하며, 이 지점에서 확률은 1입니다. 자세한 내용은 서버 CPU 과부하 시 동작 제어를 참조하십시오.max_outdated_parts_loading_thread_pool_size
시작 시 비활성 데이터 파트 집합(Outdated 상태의 파트)을 로드하는 스레드 수입니다.max_part_num_to_warn
활성 파트 수가 지정된 값을 초과하면 ClickHouse 서버가system.warnings 테이블에 경고 메시지를 추가합니다.
예시
max_partition_size_to_drop
파티션 삭제 제한입니다. MergeTree 테이블의 크기가max_partition_size_to_drop 값을 초과하면(바이트 단위) DROP PARTITION 쿼리로 파티션을 삭제할 수 없습니다.
이 설정은 적용할 때 ClickHouse 서버를 재시작할 필요가 없습니다. 제한을 비활성화하는 또 다른 방법은 <clickhouse-path>/flags/force_drop_table 파일을 생성하는 것입니다.
값
0은 아무 제한 없이 파티션을 삭제할 수 있음을 의미합니다.이 제한은 drop table 및 truncate table에는 적용되지 않습니다. max_table_size_to_drop를 참조하십시오.max_parts_cleaning_thread_pool_size
비활성 데이터 파트를 동시에 제거하는 데 사용하는 스레드 수입니다.max_per_cpu_untracked_memory
한 CPU에서 실행되는 모든 스레드가 메모리 추적기(memory tracker)에 플러시되기 전에 동시에 보유할 수 있는 미추적 메모리의 상한값(바이트 단위)입니다.max_untracked_memory가 단일 스레드의 한계를 정하는 반면, 이 설정은 CPU별 총량을 제한하므로 여러 스레드가 스레드별 허용량만큼 누적하여 서버 전체에서 큰 오버커밋이 발생하는 것을 방지합니다. 따라서 전체 미추적 메모리는 대략 number_of_cpus * max_per_cpu_untracked_memory로 제한됩니다. 값이 0이면 CPU별 제한이 비활성화되며(스레드별 max_untracked_memory만 적용됨), Linux에서만 사용할 수 있습니다.
max_session_timeout
세션 타임아웃의 최댓값(초)입니다. 예시:max_temporary_data_on_disk_size
외부 집계, 조인 또는 정렬에 사용할 수 있는 디스크 저장 공간의 최대 크기입니다. 이 한도를 초과하는 쿼리는 예외를 발생시키며 실패합니다.값이
0이면 무제한을 의미합니다.max_unexpected_parts_loading_thread_pool_size
시작할 때 비활성 데이터 파트 집합(Unexpected 파트)을 로드하는 데 사용하는 스레드 수입니다.max_waiting_queries
동시에 대기할 수 있는 전체 쿼리 수의 한도입니다. 필요한 테이블이 비동기로 로드되는 동안에는 대기 중인 쿼리의 실행이 차단됩니다(async_load_databases 참조).
다음 설정으로 제어되는 한도를 확인할 때는 대기 중인 쿼리를 계산에 포함하지 않습니다:
max_concurrent_queriesmax_concurrent_insert_queriesmax_concurrent_select_queriesmax_concurrent_queries_for_usermax_concurrent_queries_for_all_users
0 값(기본값)은 한도가 없음을 의미합니다.이 설정은 런타임에 수정할 수 있으며 즉시 적용됩니다. 이미 실행 중인 쿼리에는 영향을 주지 않습니다.max_zookeeper_pooled_connections
공유 풀에서 ZooKeeper 클러스터당 지연 초기화되는 ZooKeeper 세션의 최대 개수입니다. 값이0이면 풀링된 연결이 비활성화되며 단일 세션을 계속 사용합니다.