사용 제한

ClickHouse Cloud의 조직, warehouse, 서비스 사용 제한을 설명합니다

ClickHouse는 속도와 안정성을 염두에 두고 설계되었습니다. 최적의 성능을 유지하려면 권장되는 운영 매개변수를 지키는 것이 좋습니다. 예를 들어 TABLES, 데이터베이스, 파트가 지나치게 많으면 성능이 저하될 수 있습니다. 이를 방지하기 위해 ClickHouse Cloud는 여러 운영 차원에 걸쳐 제한을 적용합니다.

소프트 리밋은 세 가지 범위에 적용됩니다. 아래 섹션에서는 대부분의 workload가 가장 먼저 마주치는 서비스 수준 제한부터 살펴봅니다.

범위	적용 대상	이 범위의 제한
서비스	단일 서비스와 해당 컴퓨트	서비스별 컴퓨트(쿼리 동시성, 배치 수집); 독립 실행형으로 실행할 경우 데이터 객체 제한(아래 참고)
Warehouse	하나의 warehouse — 동일한 데이터를 공유하는 서비스 그룹	warehouse 전체에 걸친 레플리카 합계; Shared Catalog의 데이터 객체(TABLES, 데이터베이스 등)
Organization	ClickHouse Cloud 조직 전체(모든 warehouse와 서비스를 합친 범위)	서비스 수; warehouse 수

데이터 객체 제한(데이터베이스, TABLES, 컬럼, 파티션, 파트)이 적용되는 범위는 서비스를 어떻게 실행하느냐에 따라 달라집니다. 독립 실행형 서비스로 실행한다면 이러한 제한은 서비스마다 개별적으로 적용됩니다. 반면 여러 서비스가 warehouse에서 데이터를 공유하는 순간부터는 동일한 제한이 해당 warehouse의 Shared Catalog에 한 번만 적용됩니다. 수치 자체는 그대로이며, 측정 기준이 되는 수준만 달라집니다.

이러한 가드레일에 도달했다면 use case를 최적화되지 않은 방식으로 구현하고 있을 가능성이 있습니다. support에 문의해 주시면 가드레일을 초과하지 않도록 use case를 개선하거나, 통제된 방식으로 제한을 상향하는 방안을 함께 검토해 드리겠습니다.

​

서비스 제한

아래 제한은 독립 실행형 서비스(그리고 데이터 객체 수의 경우 해당 서비스의 스토리지)에 적용됩니다.

서비스가 warehouse에 속한 경우, 데이터 객체 제한(데이터베이스, TABLES, 컬럼, 파티션, 파트)은 아래 Warehouse 제한에서 설명하는 대로 해당 warehouse의 Shared Catalog에 적용됩니다. 값 자체는 동일하지만, 단일 서비스가 아니라 warehouse 전체를 기준으로 측정됩니다. 쿼리 동시성, 배치 수집 등 나머지 제한은 두 경우 모두 서비스별(또는 레플리카별)로 유지됩니다.

항목	제한
데이터베이스	1000
TABLES	5000
조회수	15000
딕셔너리	5000
이름이 지정된 컬렉션 (비공개 프리뷰)	1000
컬럼	~1000 (compact보다 wide format 권장)
파티션	50k
파트	10k (max_parts_in_total 설정 참조)
파트 크기	150 GB
낮은 카디널리티	10k 이하
테이블의 기본 키	데이터를 충분히 필터링할 수 있는 4~5개
쿼리 동시성	1000 (레플리카당)
배치 수집	100만 행을 초과하는 데이터는 100만 행 블록으로 분할됩니다

위 값은 기본 제한값입니다. 더 큰 서비스에는 더 많은 여유 용량이 구성되므로 특정 서비스에 적용되는 제한은 여기에 표시된 값보다 높을 수 있습니다. 서비스에 실제로 적용되는 제한은 해당 제한에 가까워질 때 받는 경고에 포함됩니다. 이미 이러한 제한을 초과한 서비스는 현재 개수에 25%를 더한 값으로 테이블 및 데이터베이스 제한이 설정됩니다.

단일 레플리카 서비스의 데이터베이스 최대 개수는 100개이며, TABLES 최대 개수는 500개입니다. 또한 Basic Tier 서비스의 스토리지는 1 TB로 제한됩니다. 위의 조회수, 딕셔너리 및 이름이 지정된 컬렉션 제한은 단일 레플리카 서비스를 포함한 모든 서비스에 동일하게 적용됩니다.

서비스별 경고 및 오류 제한은 system.server_settings를 쿼리하여 확인할 수 있습니다. 예를 들면 다음과 같습니다.

SELECT *
FROM system.server_settings
WHERE name IN ('max_table_num_to_warn', 'max_table_num_to_throw', 'max_database_num_to_warn', 'max_database_num_to_throw', 'max_view_num_to_warn', 'max_view_num_to_throw', 'max_dictionary_num_to_warn', 'max_dictionary_num_to_throw', 'max_named_collection_num_to_warn', 'max_named_collection_num_to_throw')

​

Warehouse 제한

warehouse는 동일한 데이터를 공유하는 서비스의 집합입니다. Warehouse 제한은 개별 서비스나 조직 전체가 아니라, 이 공유 그룹 전체에 적용됩니다.

차원	제한
Warehouse당 레플리카 수	50 (소프트)

레플리카 제한은 warehouse 내 모든 서비스의 레플리카 수를 합산한 값입니다. Warehouse의 모든 서비스가 하나의 ClickHouse Keeper를 공유하기 때문에, 이 제한은 Keeper의 안정성을 보호하기 위해 존재합니다. 기본값 50은 소프트 제한이며 데이터와 workload에 따라 달라집니다. ClickHouse 26.6 이상에서는 상한이 더 높으며, 향후 추가로 상향할 계획입니다. 상향이 필요한 경우 support에 문의하십시오. Warehouse 스케일링에 대한 자세한 내용은 warehouses를 참조하십시오.

On-Demand Compute는 위 표에 반영되지 않은 별도의 private 프리뷰 이용 자격 및 제한이 적용됩니다. 현재 용량, 동시성, availability에 대한 자세한 내용은 On-Demand Compute 제한 사항을 참조하십시오.

Warehouse 내 서비스 수에 대한 별도의 상한은 없으며, 위의 합산 레플리카 제한만 적용됩니다.

Warehouse 내 서비스는 하나의 catalog(동일한 TABLES, 데이터베이스, 조회수 등)를 공유하므로, 위의 서비스 수준 데이터 객체 제한은 서비스 수만큼 늘어나지 않고 warehouse당 한 번 계산됩니다. 서로 다른 warehouse는 각각 격리되어 있으므로, 각 warehouse는 자체 TABLES과 데이터베이스만 이 제한에 반영합니다.

​

조직 제한

이러한 제한은 ClickHouse Cloud 조직 전체, 즉 해당 조직의 모든 warehouse와 서비스를 합친 범위에 적용됩니다.

항목	제한
조직당 warehouse 수	제한 없음
조직당 서비스 수	20개(소프트)

조직당 서비스 수 제한은 조직 내 모든 warehouse에 속한 서비스를 전부 합산하여 계산합니다. 이는 엄격한 상한이 아니라 과거부터 유지되어 온 안전장치이므로, 지원팀에 문의하면 간단한 검토를 거쳐 대체로 상향 조정이 가능합니다.