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

> Ручное горизонтальное масштабирование в 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. Чтобы перейти на более высокий тариф, откройте страницу тарифов в облачной консоли.</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">
  ## Ручное горизонтальное масштабирование
</div>

<ScalePlanFeatureBadge feature="Ручное горизонтальное масштабирование" />

Вы можете использовать [публичные API](/docs/ru/products/cloud/api-reference/service/instance-scaling-update) 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/REHSqgCLT_igIuJP/images/cloud/manage/scaling-patch-request.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=a2af86c4f454e8dea895ec1c310940b8" size="lg" alt="PATCH-запрос на масштабирование" border width="1600" height="538" data-path="images/cloud/manage/scaling-patch-request.webp" />

*Запрос `PATCH` для обновления `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="Ответ на PATCH-запрос масштабирования" border width="1122" height="1166" data-path="images/cloud/manage/scaling-patch-response.webp" />

*Ответ на запрос `PATCH`*

Если отправить новый запрос на масштабирование или несколько запросов подряд, пока один из них уже выполняется, сервис масштабирования проигнорирует промежуточные состояния и приведёт кластер к итоговому числу реплик.

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

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

<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="Параметры масштабирования" border width="1330" height="624" data-path="images/cloud/manage/scaling-configure.webp" />

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

После масштабирования сервиса панель мониторинга метрик в облачной консоли должна показывать корректное выделение ресурсов для сервиса. На снимке экрана ниже показано, что кластер масштабирован до общего объёма памяти `96 GiB`, то есть до `6` реплик с выделением по `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="Выделение памяти при масштабировании" border width="1282" height="402" data-path="images/cloud/manage/scaling-memory-allocation.webp" />