Limites de uso

Descreve os limites de uso de organização, warehouse e serviço no ClickHouse Cloud

O ClickHouse foi construído para ser rápido e confiável. Para manter o desempenho ideal, recomendamos determinados parâmetros de operação. Por exemplo, ter tabelas, bancos de dados ou partes em excesso pode prejudicar o desempenho. Para evitar isso, o ClickHouse Cloud aplica limites em várias dimensões operacionais.

Os limites flexíveis se aplicam em três escopos diferentes. As seções abaixo começam pelos limites em nível de serviço, que são os primeiros com que a maioria dos workloads se depara.

Escopo	O que abrange	Limites nesse escopo
Serviço	Um único serviço e seu compute	Compute por serviço (concorrência de consultas, ingestão em lote); limites de objetos de dados quando executado como standalone (veja abaixo)
Warehouse	Um warehouse — o grupo de serviços que compartilham os mesmos dados	Réplicas combinadas em todo o warehouse; objetos de dados no shared catalog (tabelas, bancos de dados e assim por diante)
Organização	Toda a sua organização no ClickHouse Cloud (todos os warehouses e serviços somados)	Número de serviços; número de warehouses

O escopo dos limites de objetos de dados (bancos de dados, tabelas, colunas, partições e partes) depende de como você executa seus serviços. Se você executa serviços standalone, esses limites se aplicam por serviço. Assim que os serviços passam a compartilhar dados em um warehouse, os mesmos limites passam a valer uma única vez para o shared catalog do warehouse. Os números não mudam — muda apenas o nível em que são medidos.

Se você esbarrou em uma dessas proteções, é possível que esteja implementando seu caso de uso de forma não otimizada. Entre em contato com o suporte: teremos prazer em ajudá-lo a refinar seu caso de uso para evitar exceder essas proteções ou avaliar em conjunto como aumentá-las de maneira controlada.

​

Limites de serviço

Os limites abaixo se aplicam a um serviço standalone (e, para contagens de objetos de dados, ao armazenamento desse serviço).

Se o serviço pertencer a um warehouse, os limites de objetos de dados (bancos de dados, tabelas, colunas, partições e partes) passam a se aplicar ao shared catalog do warehouse, conforme descrito em Limites de warehouse abaixo — os valores permanecem os mesmos, mas são medidos em todo o warehouse, e não em um único serviço. Os demais limites, como concorrência de consultas e ingestão em lote, continuam sendo por serviço (ou por réplica) em ambos os casos.

Dimensão	Limite
Bancos de dados	1000
Tabelas	5000
Views	15000
Dicionários	5000
Coleções nomeadas (prévia privada)	1000
Colunas	~1000 (o formato wide é preferível ao compact)
Partições	50k
Partes	10k (consulte a configuração max_parts_in_total)
Tamanho da parte	150 GB
Baixa cardinalidade	10k ou menos
Chaves primárias em uma tabela	4–5 que filtrem suficientemente os dados
Concorrência de consultas	1000 (por réplica)
Ingestão em lote	Qualquer valor > 1 milhão de linhas é dividido em blocos de 1 milhão de linhas

Os valores acima são limites de proteção padrão. O limite aplicado a um serviço específico pode ser maior do que o valor mostrado aqui, pois serviços maiores são configurados com mais margem de capacidade. O limite efetivamente aplicável ao seu serviço é informado no aviso recebido quando você se aproxima dele. Para serviços que já excedem esses limites, os limites de tabelas e bancos de dados são definidos como a contagem atual do serviço mais 25%.

Para serviços de réplica única, o número máximo de bancos de dados é limitado a 100, e o número máximo de tabelas é limitado a 500. Além disso, o armazenamento para serviços do tier Basic é limitado a 1 TB. Os limites de view, dicionário e coleção nomeada acima correspondem a um único valor aplicável a todos os serviços, incluindo serviços de réplica única.

Os limites específicos de aviso e erro do seu serviço podem ser verificados consultando system.server_settings. Por exemplo:

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')

​

Limites de warehouse

Um warehouse é um conjunto de serviços que compartilham os mesmos dados. Os limites de warehouse se aplicam a esse grupo compartilhado como um todo — não a cada serviço separadamente nem à organização inteira.

Dimensão	Limite
Réplicas por warehouse	50 (flexível)

O limite de réplicas corresponde à contagem combinada de réplicas de todos os serviços do warehouse. Como todos os serviços de um warehouse compartilham um único ClickHouse Keeper, esse limite existe para preservar a estabilidade do Keeper. O padrão de 50 é flexível e depende dos seus dados e da sua workload; o teto é maior no ClickHouse 26.6+, e pretendemos elevá-lo ainda mais no futuro. Entre em contato com o suporte para aumentá-lo; para mais detalhes sobre o scaling de warehouses, consulte warehouses.

O On-Demand Compute possui critérios de elegibilidade e limites próprios de prévia privada que não estão representados na tabela acima. Consulte as limitações do On-Demand Compute para detalhes atuais de capacidade, concorrência e availability.

Não há um limite separado para a quantidade de serviços em um warehouse — ela é restringida apenas pelo limite combinado de réplicas acima.

Como os serviços de um warehouse compartilham um único catalog (as mesmas tabelas, bancos de dados, views e assim por diante), os limites de objetos de dados em nível de serviço descritos acima são contados uma vez por warehouse, e não multiplicados por serviço. Warehouses distintos são isolados entre si, portanto cada warehouse contabiliza suas próprias tabelas e bancos de dados nesses limites.

​

Limites da organização

Esses limites se aplicam a toda a organização do ClickHouse Cloud — ou seja, ao conjunto de todos os seus warehouses e serviços.

Dimensão	Limite
Warehouses por organização	Sem limite
Serviços por organização	20 (flexível)

O limite de serviços por organização contabiliza todos os serviços de todos os warehouses da organização. Trata-se de uma proteção herdada do passado, e não de um limite rígido; entre em contato com o suporte, que normalmente consegue aumentá-lo após uma breve análise.