> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/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 プランで利用できます。アップグレードするには、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>

ClickHouse Cloudの[public APIs](/api-reference/organization/get-list-of-available-organizations#/paths/~1v1~1organizations~1:organizationId~1services~1:serviceId~1scaling/patch)を使用すると、サービスのスケーリング設定を更新してサービスをスケールしたり、Cloud Console からレプリカ数を調整したりできます。

**Scale** ティアと **Enterprise** ティアでは、単一レプリカのサービスもサポートされています。いったんスケールアウトしたサービスは、最小で単一レプリカまでスケールインできます。ただし、単一レプリカのサービスは可用性が低くなるため、本番環境での利用は推奨されません。

<Note>
  サービスは水平方向に最大 20 レプリカまでスケールできます。さらにレプリカが必要な場合は、サポートチームまでお問い合わせください。
</Note>

<div id="horizontal-scaling-via-api">
  ### API を介した水平スケーリング
</div>

クラスターを水平スケーリングするには、API 経由で `PATCH` リクエストを送信してレプリカ数を調整します。以下のスクリーンショットは、`3` レプリカのクラスターを `6` レプリカへスケールアウトする API 呼び出しと、それに対応するレスポンスを示しています。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/fnZpjDPmkG606nII/images/cloud/manage/scaling-patch-request.png?fit=max&auto=format&n=fnZpjDPmkG606nII&q=85&s=a03700b8c359de6359dc86a506299aea" size="lg" alt="スケーリング PATCH リクエスト" border width="1600" height="538" data-path="images/cloud/manage/scaling-patch-request.png" />

*`numReplicas` を更新する `PATCH` リクエスト*

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/fnZpjDPmkG606nII/images/cloud/manage/scaling-patch-response.png?fit=max&auto=format&n=fnZpjDPmkG606nII&q=85&s=20e280f40d0fa647e63fc22704cf117e" 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">
  ### UI による水平スケーリング
</div>

UI からサービスを水平スケーリングするには、**Settings** ページでそのサービスのレプリカ数を調整します。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/fnZpjDPmkG606nII/images/cloud/manage/scaling-configure.png?fit=max&auto=format&n=fnZpjDPmkG606nII&q=85&s=1bcb2f024a548eece78e8f9d227424d4" size="md" alt="スケーリング設定" border width="1330" height="624" data-path="images/cloud/manage/scaling-configure.png" />

*ClickHouse Cloud console のサービスのスケーリング設定*

サービスのスケーリングが完了すると、ClickHouse Cloud console のメトリクスダッシュボードに、そのサービスへの割り当てが正しく表示されます。以下のスクリーンショットでは、クラスターは合計メモリ `96 GiB` までスケールしており、これはそれぞれ `16 GiB` のメモリが割り当てられた `6` 個のレプリカに相当します。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/fnZpjDPmkG606nII/images/cloud/manage/scaling-memory-allocation.png?fit=max&auto=format&n=fnZpjDPmkG606nII&q=85&s=bbe210caf9f488ff9a2252e693b0baa5" size="md" alt="スケーリング時のメモリ割り当て" border width="1282" height="402" data-path="images/cloud/manage/scaling-memory-allocation.png" />