> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/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", background}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} style={{
    backgroundColor
  }} />
      </Frame>
    </div>;
};

<h2 id="manual-horizontal-scaling">
  Escalonamento horizontal manual
</h2>

<ScalePlanFeatureBadge feature="Escalonamento horizontal manual" />

Você pode usar as [APIs públicas](/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>
  Para conhecer os limites de réplicas que se aplicam ao seu serviço, consulte [Limites de uso](/pt-BR/cloud/bestpractices/usage-limits). Entre em contato com nossa equipe de suporte se você precisar de réplicas adicionais.
</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-parallel-read-in-order-multi-part/xI74_SSNk8kNyW21/images/cloud/manage/scaling-patch-request.webp?fit=max&auto=format&n=xI74_SSNk8kNyW21&q=85&s=c4c66bd8655aaa36ff102e964d872cb8" 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-parallel-read-in-order-multi-part/xI74_SSNk8kNyW21/images/cloud/manage/scaling-patch-response.webp?fit=max&auto=format&n=xI74_SSNk8kNyW21&q=85&s=6b57ba0a1a95074f98fa4a19867566bc" 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.

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

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-parallel-read-in-order-multi-part/xI74_SSNk8kNyW21/images/cloud/manage/scaling-configure.webp?fit=max&auto=format&n=xI74_SSNk8kNyW21&q=85&s=f463bf271ea505e114725f974a9d63ae" 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-parallel-read-in-order-multi-part/xI74_SSNk8kNyW21/images/cloud/manage/scaling-memory-allocation.webp?fit=max&auto=format&n=xI74_SSNk8kNyW21&q=85&s=4cf958bd913dc1ef511b1b14806fa737" size="md" alt="Alocação de memória do escalonamento" border width="1282" height="402" data-path="images/cloud/manage/scaling-memory-allocation.webp" />