Skip to main content
ClickHouse 的设计目标是速度与可靠性。为保持最佳性能,我们建议遵循一定的运行参数。例如,表、数据库或 parts 过多都会对性能产生负面影响。为避免这种情况,ClickHouse Cloud 在多个运行维度上施加了限制。 Soft limits 适用于三种不同的范围。以下各节从服务级限制开始介绍,这也是大多数工作负载最先遇到的限制。 数据对象限制 (数据库、表、列、分区和 parts) 适用于哪个范围,取决于你如何运行服务。 如果运行的是 独立服务,这些限制按单个服务分别计算。 一旦多个服务在仓库中共享数据,同样的限制就改为整体作用于该仓库的共享 Shared Catalog。 数值本身不变——变化的只是衡量的层级。
如果你触及了其中某项防护限制,可能说明你实现用例的方式还有优化空间。请联系支持团队,我们很乐意协助你优化用例以避免超出这些防护限制,或与你一起探讨如何以可控的方式提高上限。

服务限制

以下限制适用于独立服务 (对于数据对象数量,则适用于该服务的存储) 。 如果该服务属于某个仓库,则数据对象限制 (数据库、表、列、分区和 parts) 改为适用于该仓库的 Shared Catalog,如下文仓库限制所述——数值保持不变,但按整个仓库而非单个服务来计量。其余限制,例如查询并发度和批量摄取,在两种情况下都仍按服务 (或按副本) 计算。 上述数值为默认防护限制。特定服务实际执行的限制可能高于此处显示的值,因为较大的服务会配置更多余量。实际适用于您服务的限制会显示在您接近该限制时收到的警告中。对于已超过这些限制的服务,表和数据库限制设为该服务当前数量加上 25%。
对于单副本服务,数据库数量上限为 100,表数量上限为 500。此外, Basic tier 服务的存储上限为 1 TB。上述视图、字典和命名 集合限制为适用于所有服务的统一数值, 包括单副本服务。
可通过查询 system.server_settings 验证适用于您服务的具体警告和拒绝限制。例如:

仓库限制

仓库是一组共享同一份数据的服务。 仓库限制针对该共享组整体生效,而非针对每个服务单独生效,也不是按组织整体计算。 该副本限制指仓库中所有服务的合计副本数。 由于仓库中的所有服务共享同一个 ClickHouse Keeper,设置此限制是为了保障 Keeper 的稳定性。默认值 50 为软限制,实际取决于你的数据和工作负载;在 ClickHouse 26.6+ 上该上限更高,我们也计划在未来进一步提高。 如需调高此限制,请联系支持团队;有关仓库扩缩容的更多详情,请参阅仓库。
按需计算 (On-Demand Compute) 具有独立的私有预览准入条件和限制,未体现在上表中。有关当前容量、并发和可用性的详情,请参阅按需计算限制。
仓库中的服务数量没有单独的上限,仅受上述合计副本数限制的约束。 由于同一仓库中的服务共享一个 catalog (相同的表、数据库、视图等) ,上文的服务级数据对象限制按仓库计一次,而不会随服务数量成倍增加。不同仓库之间相互隔离,因此每个仓库各自统计自己的表和数据库是否达到这些限制。

组织限制

这些限制适用于整个 ClickHouse Cloud 组织,即该组织下所有仓库和服务的总和。 每个组织的服务数限制会统计组织中所有仓库下的每一个服务。这是历史遗留的防护限制,而非硬性上限;您可以联系支持团队,通常经过简单审核后即可上调该限制。
最后修改于 2026年9月26日