バージョン: User Guides (Cloud)

📘 このページは機械翻訳された日本語版です。内容に誤りがございましたら、報告していただけると助かります。

クラスタ作成

Zilliz Cloudは、ユーザーのビジネスニーズに対応するために、さまざまなクラスタープランレベルを提供しています。適切なクラスタータイプの選択に関するガイダンスについては、クイックスタートと詳細なプラン比較を参照してください。

このトピックでは、クラスターを作成する方法について説明します。

前提条件

確認する:

Zilliz Cloudへの登録手順については、Zilliz Cloudに登録するを参照してください。
クラスターを設立する組織またはプロジェクトの所有権。役割と権限の詳細については、「アクセス制御」を参照してください。

無料クラスタを設定する

Cloud Console
cURL

Zilliz Cloudコンソールに移動してログインします。
適切な組織とプロジェクトを選択します。
[無料クラスタを作成]をクリックします。

[新しいクラスタを作成]セクションで、[無料プラン]を選択し、必要なパラメータを入力します。

📘ノート

各ユーザーには1つの無料クラスターが許可されています。追加のクラスターについては、サーバーレスまたは専用プランを選択してください。

パラメータ	説明する
クラスタ名	クラスターの名前。
クラウドプロバイダーと地域	クラスターの場所とホストされているクラウドプロバイダー。現在、無料のクラスターはGoogle Cloud Platform（GCP）で利用可能です。詳細については、クラウドプロバイダー&地域を参照してください。

create_cluster_02

[作成]をクリックします。クラスター詳細ページにリダイレクトされ、クラスターのパブリックエンドポイントとAPIキーが表示されます。これらの詳細を記録して、今後のアクセスに備えます。

リクエストは次の例のようになります。{API_KEY}は認証に使用するAPIキーです。

次のPOST要求は、リクエストボディを受け取り、IDがcluster-freeのプロジェクトに空きクラスタを作成しまproj-xxxxxxxxxxxxxxxxxxxxx。

curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/clusters/createFree" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --data-raw '{
        "clusterName": "cluster-free",
        "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
        "regionId": "gcp-us-west1"
    }'
     
# {
#     "code": 0,
#     "data": {
#         "clusterId": "inxx-xxxxxxxxxxxxxxx",
#         "username": "db_xxxxxxxx",
#         "password": "*************",
#         "prompt": "successfully submitted, cluster is being created. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK with the admin account and the initial password you specified."
#     }
# }

上記のコマンドで、

{API_KEY}: APIリクエストを認証するために使用される資格情報。値を自分のものに置き換えてください。
cluster terName:作成するクラスタの名前。
projectId:クラスタを作成するプロジェクトのID。プロジェクトIDを一覧表示するには、List Projects操作を呼び出します。
regionId:クラスタを作成するクラウドリージョンのIDです。現在、空きクラスタはGCP上でのみ作成できます。利用可能なクラウドリージョンIDを取得するには、List Cloud Regions操作を呼び出してください。

サーバーレスクラスタを設定する

Cloud Console
cURL

Zilliz Cloudコンソールに移動してログインします。
適切な組織とプロジェクトを選択します。
[+クラスタ]をクリックします。

[新しいクラスタを作成]セクションで、[サーバーレス]プランを選択し、必要なパラメータを入力します。

パラメータ	説明する
クラスタ名	クラスターの名前。
クラウドプロバイダーと地域	クラスタの場所とそれがホストされているクラウドプロバイダ。現在、サーバーレスクラスタはGoogle Cloud Platform（GCP）で利用可能です。詳細については、クラウドプロバイダー&地域を参照してください。

create_serverless_cluster_form

[作成]をクリックします。クラスター詳細ページにリダイレクトされ、クラスターのパブリックエンドポイントとAPIキーが表示されます。これらの詳細を記録して、今後のアクセスに備えます。

リクエストは次の例のようになります。{API_KEY}は認証に使用するAPIキーです。

次のPOST要求は、リクエストボディを受け取り、IDcluster-everlessという名前のサーバーレスクラスターをプロジェクトに作成しまproj-xxxxxxxxxxxxxxxxxxxxx。

curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/clusters/createServerless" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --data-raw '{
        "clusterName": "cluster-serverless",
        "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxxx",
        "regionId": "gcp-us-west1"
    }'
     
# {
#     "code": 0,
#     "data": {
#         "clusterId": "inxx-xxxxxxxxxxxxxxx",
#         "username": "db_xxxxxxxx",
#         "password": "***********",
#         "prompt": "successfully submitted, cluster is being created. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK with the admin account and the initial password you specified."
#     }
# }

上記のコマンドで、

{API_KEY}: APIリクエストを認証するために使用される資格情報。値を自分のものに置き換えてください。
cluster terName:作成するクラスタの名前。
projectId:クラスタを作成するプロジェクトのID。プロジェクトIDを一覧表示するには、List Projects操作を呼び出します。
regionId:クラスタを作成するクラウドリージョンのIDです。現在、空きクラスタはGCP上でのみ作成できます。利用可能なクラウドリージョンIDを取得するには、List Cloud Regions操作を呼び出してください。

専用のクラスタを作成

Cloud Console
cURL

Zilliz Cloudコンソールにログインします。
希望の組織とプロジェクトを入力します。
[+クラスタ]をクリックします。
[新しいクラスターを作成]ページで、関連するパラメータを入力します。
- クラスター名:クラスターに一意の識別子を割り当てます。
- クラウドプロバイダー設定:クラウドサービスプロバイダーと、クラスターをデプロイする特定のリージョンを選択します。詳細については、「クラウドプロバイダー&地域」を参照してください。
- CUの設定:
  - CUタイプ:クラスタのパフォーマンス要件に合わせたCUタイプを選択します。詳細については、「適切なCUを選択」を参照してください。
  - CU Size:クラスタの合計体格をCU単位で選択します。
- クラウドバックアップ:クラスタ内に保存されているデータを保護し、障害が発生した場合にデータの永続性と回復機能を確保するために、自動クラウドバックアップを有効にするかどうかを決定します。
[クラスタを作成]をクリックします。クラスタアクセスのパブリックエンドポイントとトークンを表示するダイアログにリダイレクトされます。これらの詳細は安全に保管してください。

リクエストは次の例のようになります。{API_KEY}は認証に使用するAPIキーです。

次のPOST要求は、リクエストボディを受け取り、1つのPerformance-optimizedCUを持つ専用のクラスタcluster-02を作成します。

curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/clusters/createDedicated" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --data-raw '{
        "clusterName": "Cluster-02",
        "projectId": "proj-xxxxxxxxxxxxxxxxxxxxxx",
        "regionId": "aws-us-west-2",
        "plan": "Standard",
        "cuType": "Performance-optimized",
        "cuSize": 1
    }'
     
# {
#     "code": 0,
#     "data": {
#         "clusterId": "inxx-xxxxxxxxxxxxxxx",
#         "username": "db_admin",
#         "password": "****************",
#         "prompt": "successfully submitted, cluster is being created. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK with the admin account and the initial password you specified."
#     }
# }

上記のコマンドで、

{API_KEY}:APIリクエストを認証するために使用される資格情報。値を自分のものに置き換えてください。
cluster terName:作成するクラスタの名前。
projectId:クラスタを作成するプロジェクトのID。プロジェクトIDを一覧表示するには、List Projects操作を呼び出します。
regionId:クラスターを作成するクラウドリージョンのID。利用可能なクラウドリージョンIDを取得するには、List Cloud Regions操作を呼び出します。
プラン: Zilliz Cloudサービスのプランレベル。有効な値:StandardとEnterprise。
cuType:クラスタに使用されるCUのタイプ。有効な値:Performance-optimizedとCapacity-Optimized。
cuSize:クラスタに使用するCUのサイズです。値の範囲は1から256までです。Create Clusterを呼び出すことで、最大32個のCUを持つクラスタを作成できます。32個以上のCUを持つクラスタを作成する場合は、お問い合わせください。

検証する

クラスターを作成したら、クラスターリストページでその状態を確認できます。実行中の状態のクラスターは、作成に成功したことを示します。

前提条件​

無料クラスタを設定する​

サーバーレスクラスタを設定する​

専用のクラスタを作成​

検証する​

前提条件

無料クラスタを設定する

サーバーレスクラスタを設定する

専用のクラスタを作成

検証する