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

# Масштабирование DB ClickPipes через OpenAPI

> Как масштабировать Postgres ClickPipes через OpenAPI

<Warning>
  **Большинству пользователей этот API не нужен**

  Конфигурация DB ClickPipes по умолчанию рассчитана на то, чтобы без дополнительной настройки справляться с большинством рабочих нагрузок. Если вы считаете, что вашей рабочей нагрузке требуется масштабирование, откройте [обращение в поддержку](https://clickhouse.com/support/program), и мы поможем подобрать оптимальные настройки для вашего сценария.
</Warning>

API масштабирования может быть полезен в следующих случаях:

* Крупные первичные загрузки (более 4 ТБ)
* Миграция умеренного объёма данных с максимально возможной скоростью
* Поддержка более 8 CDC ClickPipes в рамках одного сервиса

Прежде чем увеличивать масштаб, учтите следующее:

* Убедитесь, что у исходной БД достаточно доступных ресурсов
* Сначала настройте [параллелизм первичной загрузки и партиционирование](/ru/integrations/clickpipes/postgres/parallel-initial-load) при создании ClickPipe
* Проверьте, нет ли в источнике [длительных транзакций](/ru/integrations/clickpipes/postgres/controlling-sync#transactions), которые могут вызывать задержки CDC

**Увеличение масштаба пропорционально повысит ваши затраты на вычислительные ресурсы ClickPipes.** Если вы увеличиваете масштаб только ради первичной загрузки, важно уменьшить его после завершения снимка, чтобы избежать неожиданных расходов. Подробнее о ценах см. в разделе [Тарификация Postgres CDC](/ru/products/cloud/reference/billing/clickpipes).

<div id="prerequisites">
  ## Предварительные требования для этого процесса
</div>

Перед началом вам потребуется:

1. [ключ API ClickHouse](/ru/products/cloud/features/admin-features/api/openapi) с правами Admin на целевом сервисе ClickHouse Cloud.
2. DB ClickPipe (Postgres, MySQL или MongoDB) должен быть хотя бы один раз создан в сервисе. Инфраструктура CDC создается вместе с первым ClickPipe, и с этого момента становятся доступны конечные точки масштабирования.

<div id="cdc-scaling-steps">
  ## Шаги по масштабированию DB ClickPipes
</div>

Перед выполнением любых команд задайте следующие переменные окружения:

```bash theme={null}
ORG_ID=<Your ClickHouse organization ID>
SERVICE_ID=<Your ClickHouse service ID>
KEY_ID=<Your ClickHouse key ID>
KEY_SECRET=<Your ClickHouse key secret>
```

Получите текущую конфигурацию масштабирования (при необходимости):

```bash theme={null}
curl --silent --user $KEY_ID:$KEY_SECRET \
https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/clickpipesCdcScaling \
| jq

# пример результата:
{
  "result": {
    "replicaCpuMillicores": 2000,
    "replicaMemoryGb": 8
  },
  "requestId": "04310d9e-1126-4c03-9b05-2aa884dbecb7",
  "status": 200
}
```

Установите нужный уровень масштабирования. Поддерживаются конфигурации с 1–24 ядрами CPU, при этом объём памяти (ГБ) задаётся как 4× от числа ядер:

```bash theme={null}
cat <<EOF | tee cdc_scaling.json
{
  "replicaCpuMillicores": 24000,
  "replicaMemoryGb": 96
}
EOF

curl --silent --user $KEY_ID:$KEY_SECRET \
-X PATCH -H "Content-Type: application/json" \
https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/clickpipesCdcScaling \
-d @cdc_scaling.json | jq
```

Подождите, пока изменения конфигурации вступят в силу (обычно 3–5 минут). После завершения масштабирования конечная точка для GET-запроса отобразит новые значения:

```bash theme={null}
curl --silent --user $KEY_ID:$KEY_SECRET \
https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/clickpipesCdcScaling \
| jq

# пример результата:
{
  "result": {
    "replicaCpuMillicores": 24000,
    "replicaMemoryGb": 96
  },
  "requestId": "5a76d642-d29f-45af-a857-8c4d4b947bf0",
  "status": 200
}
```