グローバルクラスターの作成

プランでの提供状況

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

リージョンでの提供状況

この機能は、サポートされているすべての AWS リージョンで利用できます。また、リクエストに応じて Google Cloud の us-central1 および us-east4 リージョンでも利用できます。この機能は Microsoft Azure では利用できません。

このガイドでは、グローバルクラスターの作成方法について説明します。

既存のクラスターでグローバルクラスター機能を有効にする場合は、クラスターの管理 を参照してください。

事前準備

• Project Admin であることを確認してください。

• 現在、この機能はすべての AWS リージョンおよび Google Cloud の us-central1、us-east4 リージョンで利用できます。Google Cloud リージョンでグローバルクラスターを作成する場合は、お問い合わせ ください。

• グローバルクラスターは Milvus 2.6.x にのみ対応しています。

グローバルクラスターの作成

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

  1

  Turn on the switch next to Global Cluster in Cluster Settings.

  2

  グローバルクラスターの名前を入力します。

  

  3

  プライマリクラスターを設定します。

  

  各パラメーターの説明は以下のとおりです。

  パラメーター	説明
  クラスター名	プライマリクラスターの名前です。
  リージョン	プライマリクラスターをデプロイするリージョンです。
  クラスタータイプ	プライマリクラスターのクラスタータイプです。すべてのセカンダリクラスターには、プライマリクラスターと同じクラスタータイプが適用されます。
  Query CU	自動スケーリングはデフォルトで有効になっています。入力ボックスに値を入力するかスライダーをドラッグすることで、自動スケーリング時の最小・最大 Query CU 数を設定できます。自動スケーリングの詳細については、自動スケーリング を参照してください。 自動スケーリングを無効にすることも可能です。 セカンダリクラスターの Query CU 数は、プライマリクラスターの設定に連動します。
  レプリカ	プライマリクラスターのレプリカ数です。レプリカ数は、プライマリクラスターと各セカンダリクラスターで異なる値を設定できます。

  4

  セカンダリクラスターを設定します。セカンダリクラスターは 最大 5 つ まで作成できます。

  

  各パラメーターの説明は以下のとおりです。

  パラメーター	説明
  クラスター名	セカンダリクラスターの名前です。
  リージョン	セカンダリクラスターをデプロイするリージョンです。
  レプリカ	セカンダリクラスターのレプリカ数です。レプリカ数は、プライマリクラスターと各セカンダリクラスターで異なる値を設定できます。

  5

  Create をクリックします。

  

  グローバルクラスターを作成すると、Zilliz Cloud が以下の処理を実行します。

  1. グローバルクラスターと、そのプライマリクラスターおよびセカンダリクラスターをプロビジョニングします。すべてのプライマリクラスターとセカンダリクラスターは CREATING ステータスで表示されます。

  2. プライマリクラスターとセカンダリクラスターの両方のプロビジョニングが完了すると、クラスターは RUNNING ステータスで表示され、データレプリケーションをサポートします。

  You can monitor the data synchronization status and lag on the Global Topology tab of the Global Cluster page.

  

• RESTful API を使用する場合

  次の例では、1 つのプライマリクラスターを AWS us-west-2 に、1 つのセカンダリクラスターを AWS eu-west-1 にデプロイしたグローバルクラスターを作成します。API の詳細については、グローバルクラスターの作成 を参照してください。

  bash

  export API_KEY="YOUR_API_KEY"
  
  curl --request POST \
    --url "https://api.cloud.zilliz.com/v2/globalClusters/create" \
    --header "Authorization: Bearer ${API_KEY}" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data-raw '{
      "globalClusterName": "my-global-cluster",
      "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
      "cuType": "Performance-optimized",
      "cuSize": 4,
      "primaryCluster": {
        "clusterName": "primary-cluster",
        "regionId": "aws-us-west-2"
      },
      "secondaryClusters": [
        {
          "clusterName": "secondary-cluster-eu",
          "regionId": "aws-eu-west-1"
        }
      ]
    }'

  出力例は以下のとおりです。

  json

  {
    "code": 0,
    "data": {
      "globalClusterId": "glo-xxxxxxxxxxxxxxxx",
      "username": "db_admin",
      "password": "********",
      "jobId": "job-xxxxxxxxxxxxxxxx"
    }
  }

  グローバルクラスターの作成時に、Query CU の自動スケーリングを設定したり、プライマリクラスターとセカンダリクラスターで個別にレプリカ数を指定したりすることもできます。以下に例を示します。

  bash

  curl --request POST \
    --url "https://api.cloud.zilliz.com/v2/globalClusters/create" \
    --header "Authorization: Bearer ${API_KEY}" \
    --header "Accept: application/json" \
    --header "Content-Type: application/json" \
    --data-raw '{
      "globalClusterName": "my-global-cluster",
      "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
      "cuType": "Performance-optimized",
      "autoscaling": {
        "cu": {
          "min": 4,
          "max": 16
        }
      },
      "primaryCluster": {
        "clusterName": "primary-cluster",
        "regionId": "aws-us-west-2",
        "replica": 2
      },
      "secondaryClusters": [
        {
          "clusterName": "secondary-cluster-eu",
          "regionId": "aws-eu-west-1",
          "replica": 1
        }
      ]
    }'