Free & Serverless Clusters

Free および Serverless cluster は serving cluster です。基本的なライフサイクルである作成、接続、管理についてはこのページを参照してください。

📘Note

Dedicated cluster については、Dedicated Cluster を参照してください。project endpoint を介したオンデマンド検索については、Connect for On-Demand Search を参照してください。

Create

Free または Serverless cluster を作成する前に、Zilliz Cloud に登録済みであり、cluster を作成する organization または project の所有権を持っていることを確認してください。

📘Note

各 organization では、作成できる Free cluster は 1 つのみです。追加の serving cluster が必要な場合は、Serverless または Dedicated を使用してください。

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

RESTful API を使用して cluster を作成することもできます。

Create a Free cluster

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

Create a Serverless cluster

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	作成する cluster の名前。
projectId	cluster を作成する project の ID。
regionId	cluster を作成するクラウドリージョンの ID。

Connect

Free および Serverless cluster は、次の serving endpoint パターンを使用します。

bash

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

cluster 詳細ページの Connect カードから cluster の public endpoint をコピーします。token としては、cluster にアクセスできる API key、または username:password 形式の cluster 認証情報のいずれかを使用します。

Python

python

from pymilvus import MilvusClient

CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT"
TOKEN = "YOUR_CLUSTER_TOKEN"

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

Java

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

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",
})

NodeJS

javascript

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

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

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

cURL

bash

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

接続を確認するには、collections の一覧取得のような軽量な操作を実行します。

python

collections = client.list_collections()
print(collections)

Manage

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

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

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

Drop

プログラムから cluster を削除するには、cluster ID を指定して drop cluster 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"