グローバルクラスタの管理

プランでの提供状況

この機能は、Business Critical（SaaS）および BYOC デプロイメントでのみ利用できます。

リージョンでの提供状況

この機能は、すべての AWS リージョンと、次の Google Cloud リージョンで利用できます：gcp-us-central1 および gcp-us-east4。Microsoft Azure では利用できません。

このページでは、セカンダリクラスタの追加と削除、グローバルクラスタの通常クラスタへの変換、およびグローバルクラスタ全体の削除について説明します。

始める前に

Project Admin であることを確認してください。
プライマリクラスタとセカンダリクラスタはいずれも一時停止できない点に注意してください。

セカンダリクラスタを追加する

リージョンのカバレッジを向上させるために、既存のグローバルクラスタに異なるリージョンのセカンダリクラスタを追加できます。

📘注

グローバルクラスタには最大 5 つのセカンダリクラスタまでしか追加できません。

新しいセカンダリクラスタを追加すると、Zilliz Cloud はそれをプロビジョニングし、プライマリクラスタからのデータレプリケーションを開始します。新しいセカンダリクラスタは CREATING ステータスで表示され、初回のデータ同期が完了すると RUNNING に移行します。

Web コンソールから

次のデモは、1 つ以上のセカンダリクラスタを追加する方法を示しています。

RESTful API 経由

次の例では、AWS ap-southeast-1 にデプロイされた secondary-cluster-ap という名前の新しいセカンダリクラスタを追加します。API の詳細については、セカンダリクラスタの追加を参照してください。

bash
curl --request POST \
  --url "https://api.cloud.zilliz.com/v2/globalClusters/glo-xxxxxxxxxxxxxxxx/secondaryClusters" \
  --header "Authorization: Bearer ${API_KEY}" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data-raw '{
    "secondaryClusters": [
      {
        "clusterName": "secondary-cluster-ap",
        "regionId": "aws-ap-southeast-1"
      }
    ]
  }'

以下は出力例です。

bash
{
  "code": 0,
  "data": {
    "jobId": "job-xxxxxxxxxxxxxxxx"
  }
}

セカンダリクラスタを削除する

そのリージョンでのカバレッジが不要になった場合や、コストを削減したい場合は、セカンダリクラスタを削除できます。

セカンダリクラスタを削除すると、次のようになります。

削除されたセカンダリクラスタは、グローバルクラスタのトポロジーから取り除かれます。
そのクラスタへのデータレプリケーションは即座に停止します。

セカンダリクラスタは、Web コンソールまたは RESTful API のいずれかで削除できます。

Web コンソールから

次のスクリーンショットは、セカンダリクラスタを削除する方法を示しています。

RESTful API 経由

次の例ではセカンダリクラスタを削除します。API の詳細については、グローバルメンバークラスタの削除を参照してください。

bash
curl --request DELETE \
  --url "https://api.cloud.zilliz.com/v2/globalClusters/glo-xxxxxxxxxxxxxxxx/clusters/in01-xxxxxxxxxxxxxxx" \
  --header "Authorization: Bearer ${API_KEY}" \
  --header "Accept: application/json"

以下は出力例です。

bash
{
  "code": 0,
  "data": {
    "globalClusterId": "glo-xxxxxxxxxxxxxxxx",
    "clusterId": "in01-xxxxxxxxxxxxxxx",
    "prompt": "The cluster has been deleted. If you consider this action to be an error, you have the option to restore the deleted cluster from the recycle bin within a 30-day period. Kindly note, this recovery feature does not apply to free clusters."
  }
}

グローバルクラスタを通常クラスタに変換する

マルチリージョン機能が不要になったものの、プライマリクラスタとそのデータは保持したい場合は、グローバルクラスタを通常の Dedicated クラスタに戻すことができます。

グローバルクラスタを通常クラスタに変換するには、次の手順を実行する必要があります。

すべてのセカンダリクラスタを削除します。

Global Cluster ページで、Actions ドロップダウンから Remove Global Endpoint をクリックします。

Qg0Mw7gCGh9vlfbMpxockJPVnUg

RESTful API を使用してグローバルエンドポイントを削除することもできます。以下はその例です。詳細については、グローバルエンドポイントの削除を参照してください。

bash
curl --request POST \
  --url "https://api.cloud.zilliz.com/v2/globalClusters/glo-xxxxxxxxxxxxxxxx/removeGlobalEndpoint" \
  --header "Authorization: Bearer ${API_KEY}" \
  --header "Accept: application/json"

グローバルエンドポイントが削除されると、グローバルエンドポイント経由で接続しているアプリケーションは直ちに切断されます。アプリケーションコード内の接続エンドポイントを必ず更新してください。変換後に何が起こるかを次の表に示します。

項目	動作
グローバルエンドポイント	直ちに削除されます。これを使用しているクライアントは切断されます。
プライマリクラスタ	通常の Dedicated クラスタになります。すべてのデータを保持したまま稼働を継続します。
データレプリケーション	停止します。データレプリケーションメトリクスは削除されます。
グローバルクラスタメタデータ	クリアされます（グローバルクラスタ ID、トポロジー）。
バックアップポリシー	以前のプライマリクラスタにそのまま残り、変更されません。
課金	データ転送料金は停止します。残るクラスタは通常の Dedicated クラスタとして課金されます。

グローバルクラスタを削除する

グローバルクラスタ全体を削除するには、まずすべてのセカンダリクラスタを削除し、その後プライマリクラスタを削除します。プライマリクラスタが削除されると、グローバルクラスタは自動的に削除されます。

始める前に​

セカンダリクラスタを追加する​

セカンダリクラスタを削除する​

グローバルクラスタを通常クラスタに変換する​