> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# 水平扩缩容

export const ScalePlanFeatureBadge = ({feature = '此功能', linking_verb_are = false}) => {
  return <div className="scalePlanFeatureContainer">
            <div className="scalePlanFeatureBadge">
                Scale 计划功能
            </div>
            <div>
                <p>{feature} {linking_verb_are ? '仅在' : '仅在'} Scale 和 Enterprise 计划中可用。要升级，请访问 Cloud Console 中的计划页面。</p>
            </div>
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

<div id="manual-horizontal-scaling">
  ## 手动水平扩缩容
</div>

您可以使用 ClickHouse Cloud 的[公共 API](/api-reference/organization/get-list-of-available-organizations#/paths/~1v1~1organizations~1:organizationId~1services~1:serviceId~1scaling/patch)，通过更新服务的扩缩容设置来对服务进行扩缩容，或者在 ClickHouse Cloud 控制台中调整副本数量。

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

<Note>
  服务最多可水平扩容到 20 个副本。如果您需要更多副本，请联系我们的支持团队。
</Note>

<div id="horizontal-scaling-via-api">
  ### 通过 API 进行水平扩缩容
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/fnZpjDPmkG606nII/images/cloud/manage/scaling-patch-request.png?fit=max&auto=format&n=fnZpjDPmkG606nII&q=85&s=a03700b8c359de6359dc86a506299aea" size="lg" alt="扩缩容 PATCH 请求" border width="1600" height="538" data-path="images/cloud/manage/scaling-patch-request.png" />

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/fnZpjDPmkG606nII/images/cloud/manage/scaling-patch-response.png?fit=max&auto=format&n=fnZpjDPmkG606nII&q=85&s=20e280f40d0fa647e63fc22704cf117e" size="md" alt="扩缩容 PATCH 响应" border width="1122" height="1166" data-path="images/cloud/manage/scaling-patch-response.png" />

*`PATCH` 请求的响应*

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

<div id="horizontal-scaling-via-ui">
  ### 通过 UI 进行水平扩缩容
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/fnZpjDPmkG606nII/images/cloud/manage/scaling-configure.png?fit=max&auto=format&n=fnZpjDPmkG606nII&q=85&s=1bcb2f024a548eece78e8f9d227424d4" size="md" alt="扩缩容配置" border width="1330" height="624" data-path="images/cloud/manage/scaling-configure.png" />

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/fnZpjDPmkG606nII/images/cloud/manage/scaling-memory-allocation.png?fit=max&auto=format&n=fnZpjDPmkG606nII&q=85&s=bbe210caf9f488ff9a2252e693b0baa5" size="md" alt="扩缩容内存分配" border width="1282" height="402" data-path="images/cloud/manage/scaling-memory-allocation.png" />