본문으로 바로가기
본문으로 바로가기

OpenAPI를 통한 MySQL ClickPipes 스케일링

대부분의 사용자에게는 이 API가 필요하지 않습니다

DB ClickPipes의 기본 설정은 별도의 조정 없이도 대부분의 워크로드를 처리할 수 있도록 설계되었습니다. 워크로드에 스케일링이 필요하다고 판단되면 지원 케이스를 등록하십시오. 해당 사용 사례에 가장 적합한 설정을 안내해 드립니다.

다음과 같은 경우 스케일링 API가 유용할 수 있습니다:

  • 대규모 초기 로드(4 TB 초과)
  • 중간 규모의 데이터를 가능한 한 빠르게 마이그레이션해야 하는 경우
  • 동일한 서비스에서 8개를 초과하는 CDC ClickPipes를 지원해야 하는 경우

스케일 업을 시도하기 전에 다음 사항을 검토하십시오:

스케일을 늘리면 ClickPipes 컴퓨트 비용도 비례하여 증가합니다. 초기 로드만을 위해 스케일 업하는 경우에는 스냅샷이 완료된 후 예상치 못한 요금이 발생하지 않도록 다시 스케일 다운하는 것이 중요합니다. 가격에 대한 자세한 내용은 ClickPipes 요금을 참조하십시오.

이 프로세스를 위한 사전 요구 사항​

시작하기 전에 다음이 필요합니다:

  1. 대상 ClickHouse Cloud 서비스에 대해 Admin 권한이 있는 ClickHouse API key
  2. 서비스에 DB ClickPipe(Postgres, MySQL 또는 MongoDB)가 이전에 한 번이라도 프로비저닝되어 있어야 합니다. CDC 인프라는 첫 번째 ClickPipe와 함께 생성되며, 그 시점부터 스케일링 엔드포인트를 사용할 수 있습니다.

DB ClickPipes 확장 방법​

명령어를 실행하기 전에 다음 환경 변수를 설정하세요:

ORG_ID=<Your ClickHouse organization ID>
SERVICE_ID=<Your ClickHouse service ID>
KEY_ID=<Your ClickHouse key ID>
KEY_SECRET=<Your ClickHouse key secret>

현재 스케일링 설정을 조회하세요(선택 사항):

curl --silent --user $KEY_ID:$KEY_SECRET \
https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/clickpipesCdcScaling \
| jq

# example result:
{
  "result": {
    "replicaCpuMillicores": 2000,
    "replicaMemoryGb": 8
  },
  "requestId": "04310d9e-1126-4c03-9b05-2aa884dbecb7",
  "status": 200
}

원하는 크기 조정 값을 설정하십시오. 지원되는 구성은 CPU 코어 1~24개이며, 메모리(GB)는 코어 수의 4배로 설정됩니다:

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 엔드포인트에 새 값이 반영됩니다:

curl --silent --user $KEY_ID:$KEY_SECRET \
https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/clickpipesCdcScaling \
| jq

# example result:
{
  "result": {
    "replicaCpuMillicores": 24000,
    "replicaMemoryGb": 96
  },
  "requestId": "5a76d642-d29f-45af-a857-8c4d4b947bf0",
  "status": 200
}