Limites d’utilisation

Décrit les limites d’utilisation applicables aux organisations, aux warehouses et aux services dans ClickHouse Cloud

ClickHouse est conçu pour la rapidité et la fiabilité. Afin de maintenir des performances optimales, nous recommandons de respecter certains paramètres de fonctionnement. Par exemple, un nombre trop élevé de tables, de bases de données ou de parts peut nuire aux performances. Pour éviter cela, ClickHouse Cloud applique des limites sur plusieurs dimensions opérationnelles.

Les soft limits s’appliquent à trois portées différentes. Les sections ci-dessous commencent par les limites au niveau du service, celles que la plupart des workloads rencontrent en premier.

Portée	Ce qu’elle couvre	Limites à cette portée
Service	Un service unique et son compute	Compute par service (concurrence des requêtes, ingestion par lots) ; limites sur les objets de données en mode standalone (voir ci-dessous)
Warehouse	Un warehouse — le groupe de services qui partagent les mêmes données	Nombre cumulé de répliques dans le warehouse ; objets de données dans le shared catalog (tables, bases de données, etc.)
Organization	L’ensemble de votre organisation ClickHouse Cloud (tous les warehouses et services confondus)	Nombre de services ; nombre de warehouses

La portée des limites d’objets de données (bases de données, tables, colonnes, partitions et parts) dépend de la manière dont vous exécutez vos services. Si vous exécutez des services standalone, ces limites s’appliquent à chaque service. Dès lors que des services partagent des données au sein d’un warehouse, ces mêmes limites s’appliquent une seule fois au shared catalog du warehouse. Les valeurs ne changent pas — seul le niveau auquel elles sont mesurées diffère.

Si vous vous heurtez à l’un de ces garde-fous, il se peut que votre use case soit mis en œuvre de manière non optimisée. Contactez le support : nous vous aiderons volontiers à affiner votre use case pour éviter de dépasser ces garde-fous, ou nous examinerons ensemble comment les relever de façon maîtrisée.

​

Limites de service

Les limites ci-dessous s’appliquent à un service standalone (et, pour le nombre d’objets de données, au stockage de ce service).

Si le service appartient à un warehouse, les limites d’objets de données (bases de données, tables, colonnes, partitions et parts) s’appliquent à la place au shared catalog du warehouse, comme décrit dans Limites des warehouses ci-dessous — les valeurs restent inchangées, mais elles sont mesurées à l’échelle de l’ensemble du warehouse plutôt que du service seul. Les autres limites, telles que la concurrence des requêtes et l’ingestion par lots, restent par service (ou par réplique) dans les deux cas.

Dimension	Limite
Bases de données	1000
Tables	5000
Vues	15000
Dictionnaires	5000
Collections nommées (aperçu privé)	1000
Colonnes	~1000 (le format wide est préférable au format compact)
Partitions	50k
Parts	10k (voir le paramètre max_parts_in_total)
Taille des parts	150 GB
Faible cardinalité	10k ou moins
Clés primaires dans une table	4 à 5, filtrant suffisamment les données
Concurrence des requêtes	1000 (par réplique)
Ingestion par lots	Tout volume > 1M lignes est divisé en blocs de 1M lignes

Les valeurs ci-dessus constituent des garde-fous par défaut. La limite appliquée à un service donné peut être supérieure à la valeur indiquée ici, car les services plus importants disposent d’une marge supplémentaire. La limite réellement applicable à votre service est indiquée dans l’avertissement que vous recevez à l’approche de cette limite. Pour les services dépassant déjà ces limites, les limites de tables et de bases de données sont fixées au nombre actuel du service, majoré de 25 %.

Pour les services à réplique unique, le nombre maximal de bases de données est limité à 100 et le nombre maximal de tables à 500. De plus, le stockage des services du niveau Basic est limité à 1 TB. Les limites de vues, de dictionnaires et de collections nommées indiquées ci-dessus correspondent à une valeur unique applicable à tous les services, y compris les services à réplique unique.

Les seuils d’avertissement et de rejet spécifiques à votre service peuvent être vérifiés en interrogeant system.server_settings. Par exemple :

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 des warehouses

Un warehouse est un ensemble de services qui partagent les mêmes données. Les limites de warehouse s’appliquent à ce groupe partagé dans son ensemble — et non à chaque service pris séparément ni à l’échelle de l’organisation.

Dimension	Limite
Répliques par warehouse	50 (souple)

La limite de répliques correspond au nombre combiné de répliques de l’ensemble des services du warehouse. Comme tous les services d’un warehouse partagent un unique ClickHouse Keeper, cette limite vise à préserver la stabilité de Keeper. La valeur par défaut de 50 est souple et dépend de vos données et de votre workload ; le plafond est plus élevé à partir de ClickHouse 26.6, et nous prévoyons de le relever davantage à l’avenir. Contactez le support pour l’augmenter ; pour plus de détails sur le scaling des warehouses, consultez warehouses.

Le compute à la demande dispose de critères d’éligibilité et de limites propres à la préversion privée, qui ne figurent pas dans le tableau ci-dessus. Consultez les limitations du compute à la demande pour connaître les détails actuels en matière de capacité, de concurrency et d’availability.

Il n’existe aucun plafond distinct sur le nombre de services dans un warehouse : celui-ci est uniquement borné par la limite combinée de répliques ci-dessus.

Comme les services d’un warehouse partagent un même catalog (les mêmes tables, bases de données, vues, etc.), les limites d’objets de données au niveau du service ci-dessus sont comptabilisées une seule fois par warehouse plutôt que multipliées par service. Les warehouses distincts sont isolés les uns des autres : chaque warehouse comptabilise donc ses propres tables et bases de données au regard de ces limites.

​

Limites par organisation

Ces limites s’appliquent à l’ensemble d’une organisation ClickHouse Cloud, c’est-à-dire à la totalité de ses warehouses et services réunis.

Dimension	Limite
Warehouses par organisation	Aucune limite
Services par organisation	20 (souple)

La limite de services par organisation comptabilise chaque service de tous les warehouses de l’organisation. Il s’agit d’un garde-fou hérité du passé plutôt que d’un plafond strict ; contactez le support, qui peut généralement le relever après une brève vérification.