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

> Ручное горизонтальное масштабирование в ClickHouse Cloud

# Горизонтальное масштабирование

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">
  ## Ручное горизонтальное масштабирование
</div>

Вы можете использовать [публичные API](/api-reference/organization/get-list-of-available-organizations#/paths/~1v1~1organizations~1:organizationId~1services~1:serviceId~1scaling/patch) ClickHouse Cloud, чтобы масштабировать сервис, обновив его параметры масштабирования, или изменить количество реплик в облачной консоли.

Уровни **Scale** и **Enterprise** также поддерживают сервисы с одной репликой. После масштабирования сервисы можно уменьшить обратно до одной реплики. Обратите внимание, что сервисы с одной репликой имеют более низкую доступность и не рекомендуются для использования в продакшне.

<Note>
  Сервисы можно масштабировать по горизонтали максимум до 20 реплик. Если вам требуется больше реплик, обратитесь в службу поддержки.
</Note>

<div id="horizontal-scaling-via-api">
  ### Горизонтальное масштабирование через API
</div>

Чтобы выполнить горизонтальное масштабирование кластера, отправьте через API запрос `PATCH`, изменив число реплик. На снимках экрана ниже показан вызов API для масштабирования кластера с `3` реплик до `6`, а также соответствующий ответ.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/-5HsuqGEaVjyHCfx/images/cloud/manage/scaling-patch-request.png?fit=max&auto=format&n=-5HsuqGEaVjyHCfx&q=85&s=20eed333c315d5b4b7ccf2fda918b6dd" size="lg" alt="PATCH-запрос на масштабирование" border width="1600" height="538" data-path="images/cloud/manage/scaling-patch-request.png" />

*Запрос `PATCH` для обновления `numReplicas`*

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/-5HsuqGEaVjyHCfx/images/cloud/manage/scaling-patch-response.png?fit=max&auto=format&n=-5HsuqGEaVjyHCfx&q=85&s=b02b6a5c0733278ff936fee76fe58338" 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">
  ### Горизонтальное масштабирование через интерфейс
</div>

Чтобы выполнить горизонтальное масштабирование сервиса через интерфейс, можно изменить количество реплик сервиса на странице **Настройки**.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/-5HsuqGEaVjyHCfx/images/cloud/manage/scaling-configure.png?fit=max&auto=format&n=-5HsuqGEaVjyHCfx&q=85&s=0b64b07f4a919b0667c311ee6000e1db" size="md" alt="Параметры масштабирования" border width="1330" height="624" data-path="images/cloud/manage/scaling-configure.png" />

*Параметры масштабирования сервиса в консоли ClickHouse Cloud*

После масштабирования сервиса панель мониторинга метрик в облачной консоли должна показывать корректное выделение ресурсов для сервиса. На снимке экрана ниже показано, что кластер масштабирован до общего объёма памяти `96 GiB`, то есть до `6` реплик с выделением по `16 GiB` памяти для каждой.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/-5HsuqGEaVjyHCfx/images/cloud/manage/scaling-memory-allocation.png?fit=max&auto=format&n=-5HsuqGEaVjyHCfx&q=85&s=dc65b7c80aee11452ab81856aceef0d8" size="md" alt="Выделение памяти при масштабировании" border width="1282" height="402" data-path="images/cloud/manage/scaling-memory-allocation.png" />