Skip to content

Commit 827b4de

Browse files
authored
Merge pull request #4224 from ClickHouse/aashishkohli-patch-11
Update scaling.md
2 parents 9d513d0 + 903469a commit 827b4de

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

docs/cloud/manage/scaling.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,10 +17,14 @@ import ScalePlanFeatureBadge from '@theme/badges/ScalePlanFeatureBadge'
1717

1818
# Automatic scaling
1919

20-
Scaling is the ability to adjust available resources to meet client demands. Scale and Enterprise (with standard 1:4 profile) tier services can be scaled horizontally by calling an API programmatically, or changing settings on the UI to adjust system resources. Alternatively, these services can be **autoscaled** vertically to meet application demands.
20+
Scaling is the ability to adjust available resources to meet client demands. Scale and Enterprise (with standard 1:4 profile) tier services can be scaled horizontally by calling an API programmatically, or changing settings on the UI to adjust system resources. These services can also be **autoscaled** vertically to meet application demands.
2121

2222
<ScalePlanFeatureBadge feature="Automatic vertical scaling"/>
2323

24+
:::note
25+
Scale and Enterprise tiers supports both single and multi-replica services, whereas, Basic tier supports only single replica services. Single replica services are meant to be fixed in size and do not allow vertical or horizontal scaling. Users can upgrade to the Scale or Enterprise tier to scale their services.
26+
:::
27+
2428
## How scaling works in ClickHouse Cloud {#how-scaling-works-in-clickhouse-cloud}
2529

2630
Currently, ClickHouse Cloud supports vertical autoscaling and manual horizontal scaling for Scale tier services.
@@ -30,7 +34,7 @@ For Enterprise tier services scaling works as follows:
3034
- **Horizontal scaling**: Manual horizontal scaling will be available across all standard and custom profiles on the enterprise tier.
3135
- **Vertical scaling**:
3236
- Standard profiles (1:4) will support vertical autoscaling.
33-
- Custom profiles will not support vertical autoscaling or manual vertical scaling at launch. However, these services can be scaled vertically by contacting support.
37+
- Custom profiles (`highMemory` and `highCPU`) do not support vertical autoscaling or manual vertical scaling. However, these services can be scaled vertically by contacting support.
3438

3539
:::note
3640
Scaling in ClickHouse Cloud happens in what we call "Make Before Break" (MBB) approach. This adds one or more replicas of the new size before removing the old replicas, preventing any loss of capacity during scaling operations. By eliminating the gap between removing existing replicas and adding new ones, MBB creates a more seamless and less disruptive scaling process. It is especially beneficial in scale-up scenarios, where high resource utilization triggers the need for additional capacity, since removing replicas prematurely would only exacerbate the resource constraints. As part of this approach we wait up to an hour to let any existing queries complete on the older replicas before we will remove them. This balances the need for existing queries to complete, while at the same time ensuring that older replicas do not linger around for too long.

0 commit comments

Comments
 (0)