> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 水平扩缩容

> ClickHouse Cloud 中的手动水平扩缩容

## 手动水平扩缩容

Scale 计划功能

手动水平扩缩容 仅在 Scale 和 Enterprise 计划中可用。要升级，请访问 Cloud Console 中的计划页面。

您可以使用 ClickHouse Cloud 的[公共 API](https://clickhouse.com/docs/zh/products/cloud/api-reference/service/instance-scaling-update)，通过更新服务的扩缩容设置来对服务进行扩缩容，或者在 ClickHouse Cloud 控制台中调整副本数量。

**Scale** 和 **Enterprise** 层级也支持单副本服务。服务在完成横向扩容后，最少可再缩减回 1 个副本。请注意，单副本服务的可用性较低，不建议用于生产环境。

> [!NOTE]
>
> 有关适用于您的服务的副本数量限制，请参阅[使用限制](https://clickhouse.com/docs/zh/cloud/bestpractices/usage-limits.md)。如果您需要更多副本，请联系我们的支持团队。

### 通过 API 进行水平扩缩容

要对集群进行水平扩缩容，请通过 API 发送 `PATCH` 请求来调整副本数量。下方截图展示了一个 API 调用：将一个 `3` 副本集群横向扩容到 `6` 个副本，以及对应的响应。

![扩缩容 PATCH 请求](https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/manage/scaling-patch-request.webp?fit=max\&auto=format\&n=96hCVnfqPOLWGWdD\&q=85\&s=bbf0d14c0d1872071cf8e5f637972802)

*用于更新 `numReplicas` 的 `PATCH` 请求*

![扩缩容 PATCH 响应](https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/manage/scaling-patch-response.webp?fit=max\&auto=format\&n=96hCVnfqPOLWGWdD\&q=85\&s=a9efe31c6b7214551eaddd40ebbb5e4b)

*`PATCH` 请求的响应*

如果某个扩缩容操作已在进行中，而你又发起了新的扩缩容请求，或连续发起多个请求，扩缩容服务会忽略中间状态，并最终收敛到最后指定的副本数量。

### 通过 UI 进行水平扩缩容

要通过 UI 对服务进行水平扩缩容，可以在 **Settings** 页面调整该服务的副本数量。

![扩缩容配置](https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/manage/scaling-configure.webp?fit=max\&auto=format\&n=96hCVnfqPOLWGWdD\&q=85\&s=6e0353eec801998dcca24fba07acd915)

*ClickHouse Cloud 控制台中的服务扩缩容设置*

服务完成扩缩容后，ClickHouse Cloud 控制台中的指标仪表板应显示分配给该服务的正确资源。下方截图显示，该集群已扩展到总内存 `96 GiB`，即 `6` 个副本，每个副本分配 `16 GiB` 内存。

![扩缩容内存分配](https://mintcdn.com/private-7c7dfe99/96hCVnfqPOLWGWdD/images/cloud/manage/scaling-memory-allocation.webp?fit=max\&auto=format\&n=96hCVnfqPOLWGWdD\&q=85\&s=7b7c4549245c1c7eea27ed57658aca47)
