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

プランでの提供状況

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

リージョンでの提供状況

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

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

事前準備

Project Admin であること。
プライマリクラスターとセカンダリクラスターはいずれも一時停止できない点に注意すること。

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

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

Notes

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

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

Web コンソールを使用する場合

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

RESTful API を使用する場合

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

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 の詳細については、Delete Global Member Cluster を参照してください。

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 を使用してグローバルエンドポイントを削除することもできます。以下に例を示します。詳細については、Remove Global Endpoint を参照してください。

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、トポロジー）。
バックアップポリシー	以前のプライマリクラスターにそのまま残り、変更されません。

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

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

事前準備​

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

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

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