メインコンテンツまでスキップ

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

プランでの提供状況

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

リージョンでの提供状況

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

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

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

事前準備​

  • Project Admin 権限を持っていることを確認してください。

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

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

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

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

    1

    クラスター設定 の グローバルクラスター にあるスイッチをオンにします。

    2

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

    C33Vw8MCshNOoAbDTbjcegOIndd

    3

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

    MkZTwsJhfhpKzUbCKcRcJscdnXe

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

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

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

    NjNUwjHuKhGRwObLoyQc1FKxnVh

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

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

    作成 をクリックします。

    Z9xYwy7dKhQMGob52EzcFpAnnmh

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

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

    2. プライマリクラスターとセカンダリクラスターの両方のプロビジョニングが完了すると、クラスターは RUNNING ステータスになり、データレプリケーションが開始されます。

    データ同期のステータスと遅延状況は、グローバルクラスター ページの グローバルトポロジー タブで確認できます。

    CLpZwH1e3hd3F1bIXisc6u7GnDg

  • RESTful API を使用する場合

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

    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",
        "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
          }
        ]
      }
Ctrl I