> ## 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.

> Escalonamento horizontal manual no ClickHouse Cloud

# Escalonamento horizontal

export const ScalePlanFeatureBadge = ({feature = 'Este recurso', linking_verb_are = false}) => {
  return <div className="scalePlanFeatureContainer">
            <div className="scalePlanFeatureBadge">
                Recurso do plano Scale
            </div>
            <div>
                <p>{feature} {linking_verb_are ? 'estão' : 'está'} disponível nos planos Scale e Enterprise. Para fazer upgrade, acesse a página de planos no Console do Cloud.</p>
            </div>
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<div id="manual-horizontal-scaling">
  ## Escalonamento horizontal manual
</div>

<ScalePlanFeatureBadge feature="Escalonamento horizontal manual" />

Você pode usar as [APIs públicas](/docs/pt-BR/products/cloud/api-reference/service/instance-scaling-update) do ClickHouse Cloud para escalar seu serviço atualizando as configurações de escalonamento do serviço ou ajustar o número de réplicas no console do ClickHouse Cloud.

Os tiers **Scale** e **Enterprise** também oferecem suporte a serviços com uma única réplica. Depois de serem expandidos horizontalmente, os serviços podem ser reduzidos novamente até o mínimo de uma única réplica. Observe que serviços com uma única réplica têm disponibilidade reduzida e não são recomendados para uso em produção.

<Note>
  Os serviços podem escalar horizontalmente até o máximo de 20 réplicas. Se você precisar de réplicas adicionais, entre em contato com nossa equipe de suporte.
</Note>

<div id="horizontal-scaling-via-api">
  ### Escalonamento horizontal via API
</div>

Para escalar horizontalmente um cluster, envie uma solicitação `PATCH` pela API para ajustar o número de réplicas. As capturas de tela abaixo mostram uma chamada de API para aumentar um cluster de `3` réplicas para `6` réplicas, e a resposta correspondente.

<Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/manage/scaling-patch-request.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=a2af86c4f454e8dea895ec1c310940b8" size="lg" alt="Solicitação PATCH de escalonamento" border width="1600" height="538" data-path="images/cloud/manage/scaling-patch-request.webp" />

*Solicitação `PATCH` para atualizar `numReplicas`*

<Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/manage/scaling-patch-response.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=81864452f7f0e1b47cabd884a5e24ea6" size="md" alt="Resposta PATCH de escalonamento" border width="1122" height="1166" data-path="images/cloud/manage/scaling-patch-response.webp" />

*Resposta à solicitação `PATCH`*

Se você enviar uma nova solicitação de escalonamento, ou várias solicitações em sequência, enquanto outra já estiver em andamento, o serviço de escalonamento ignorará os estados intermediários e convergirá para a contagem final de réplicas.

<div id="horizontal-scaling-via-ui">
  ### Escalonamento horizontal pela UI
</div>

Para escalar um serviço horizontalmente pela UI, você pode ajustar o número de réplicas do serviço na página **Settings**.

<Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/manage/scaling-configure.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=41abfbb426f794acc253ee88dce4beb5" size="md" alt="Configurações de escalonamento" border width="1330" height="624" data-path="images/cloud/manage/scaling-configure.webp" />

*Configurações de escalonamento do serviço no console do ClickHouse Cloud*

Depois que o serviço for escalado, o dashboard de métricas no console do ClickHouse Cloud deverá mostrar a alocação correta do serviço. A captura de tela abaixo mostra o cluster escalado para uma memória total de `96 GiB`, isto é, `6` réplicas, cada uma com alocação de memória de `16 GiB`.

<Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/manage/scaling-memory-allocation.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=674b5879f9770e1eb108d7251d8a5ea4" size="md" alt="Alocação de memória do escalonamento" border width="1282" height="402" data-path="images/cloud/manage/scaling-memory-allocation.webp" />