> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.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 = 'This feature', linking_verb_are = false}) => {
  return <div className="scalePlanFeatureContainer">
            <div className="scalePlanFeatureBadge">
                Scale plan feature
            </div>
            <div>
                <p>{feature} {linking_verb_are ? 'are' : 'is'} available in the Scale and Enterprise plans. To upgrade, visit the plans page in the cloud console.</p>
            </div>
        </div>;
};

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

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

Você pode usar as [APIs públicas](/api-reference/organization/get-list-of-available-organizations#/paths/~1v1~1organizations~1:organizationId~1services~1:serviceId~1scaling/patch) 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-home-button/q-fyjp7bh9TLY82A/images/cloud/manage/scaling-patch-request.png?fit=max&auto=format&n=q-fyjp7bh9TLY82A&q=85&s=7e438a174346184c6d627cfc202e758b" size="lg" alt="Solicitação PATCH de escalonamento" border width="1600" height="538" data-path="images/cloud/manage/scaling-patch-request.png" />

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

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

*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-home-button/q-fyjp7bh9TLY82A/images/cloud/manage/scaling-configure.png?fit=max&auto=format&n=q-fyjp7bh9TLY82A&q=85&s=fe0aed26599c40238ff179d8e3f2541d" size="md" alt="Configurações de escalonamento" border width="1330" height="624" data-path="images/cloud/manage/scaling-configure.png" />

*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-home-button/q-fyjp7bh9TLY82A/images/cloud/manage/scaling-memory-allocation.png?fit=max&auto=format&n=q-fyjp7bh9TLY82A&q=85&s=7cbd32b9f63c7e29139848f7dcf1302a" size="md" alt="Alocação de memória do escalonamento" border width="1282" height="402" data-path="images/cloud/manage/scaling-memory-allocation.png" />
