Free & Serverless クラスター

Free および Serverless クラスターはサービングクラスターです。作成、接続、管理という基本的なライフサイクルについては、このページを参照してください。

Note

Dedicated クラスターについては、Dedicated クラスターを参照してください。プロジェクトエンドポイントを介したオンデマンド検索については、オンデマンド検索への接続を参照してください。

Create

Free または Serverless クラスターを作成する前に、Zilliz Cloud に登録済みであり、クラスターを作成する組織またはプロジェクトの所有権を持っていることを確認してください。

Note

各組織で作成できる Free クラスターは 1 つのみです。追加のサービングクラスターが必要な場合は、Serverless または Dedicated を使用してください。

Zilliz Cloud コンソールから Free または Serverless クラスターを作成できます。クラスターのステータスが Running に変わると、クラスターの準備は完了です。作成時に表示されるクラスター認証情報は保存してください。パスワードは一度しか表示されません。

RESTful API を使用してクラスターを作成することもできます。

Free クラスターを作成する

bash
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"
    }'

Serverless クラスターを作成する

bash
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"
    }'

Parameter	説明
`API_KEY`	control-plane API リクエストの認証に使用する API key。
`clusterName`	作成するクラスターの名前。
`projectId`	クラスターを作成するプロジェクトの ID。
`regionId`	クラスターを作成するクラウドリージョンの ID。

Connect

Free および Serverless クラスターでは、以下のサービングエンドポイントパターンを使用します。

bash

https://{cluster-id}.serverless.{region}.vectordb.zillizcloud.com

クラスターの詳細ページの Connect カードから、クラスターのパブリックエンドポイントをコピーします。トークンには、そのクラスターにアクセスできる API キー、または username:password 形式のクラスター認証情報のいずれかを使用します。

Python
Java
Go
NodeJS
cURL

python
from pymilvus import MilvusClient

CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT"
TOKEN = "YOUR_CLUSTER_TOKEN"

client = MilvusClient(
    uri=CLUSTER_ENDPOINT,
    token=TOKEN,
)

java
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.client.ConnectConfig;

String CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT";
String TOKEN = "YOUR_CLUSTER_TOKEN";

ConnectConfig connectConfig = ConnectConfig.builder()
    .uri(CLUSTER_ENDPOINT)
    .token(TOKEN)
    .build();

MilvusClientV2 client = new MilvusClientV2(connectConfig);

go
import "github.com/milvus-io/milvus/client/v2/milvusclient"

client, err := milvusclient.New(ctx, &milvusclient.ClientConfig{
    Address: "YOUR_CLUSTER_ENDPOINT",
    APIKey:  "YOUR_CLUSTER_TOKEN",
})

javascript
const { MilvusClient } = require("@zilliz/milvus2-sdk-node");

const address = "YOUR_CLUSTER_ENDPOINT";
const token = "YOUR_CLUSTER_TOKEN";

const client = new MilvusClient({ address, token });

bash
curl --request POST \
  --url "YOUR_CLUSTER_ENDPOINT" \
  --header "Authorization: Bearer YOUR_CLUSTER_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"dbName": "default"}'

接続を確認するには、コレクションの一覧表示のような軽量な操作を実行します。

python
collections = client.list_collections()
print(collections)

Manage

Free および Serverless クラスターは、クラスター詳細ページから管理できます。

Operation	Free クラスター	Serverless クラスター
Rename	サポートされています。	サポートされています。
Resume	Free クラスターは、7 日間連続で非アクティブな場合に自動的に一時停止され、いつでも再開できます。	Serverless クラスターは、一時停止および再開操作をサポートしていません。
Upgrade deployment option	Serverless または Dedicated にアップグレードできます。Free から Dedicated へのアップグレードでは、新しい Dedicated クラスターが作成され、Free クラスターからデータが移行されます。	Dedicated にアップグレードできます。Serverless から Dedicated へのアップグレードでは、新しい Dedicated クラスターが作成され、Serverless クラスターからデータが移行されます。
Drop	サポートされています。Free クラスターは、削除後にごみ箱から復元できません。	サポートされています。

アップグレードによって新しい Dedicated クラスターが作成される場合は、アプリケーションコード内のクラスターエンドポイントを忘れずに更新してください。

Drop

プログラムからクラスターを削除するには、クラスター ID を指定してクラスター削除 API を呼び出します。

bash
curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/clusters/${CLUSTER_ID}/drop" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json"

Create​

Free クラスターを作成する​

Serverless クラスターを作成する​

Connect​

Manage​

Drop​