Free & Serverless クラスター

Free クラスターと Serverless クラスターはサービングクラスターです。このページでは、作成、接続、管理という基本的なライフサイクルについて説明します。

Note

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

作成

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

Note

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

Free クラスターまたは Serverless クラスターは、Zilliz Cloud コンソールから作成できます。クラスターのステータスが Running に変わると、クラスターを使用できる状態になります。パスワードは 1 回しか表示されないため、作成時に表示されるクラスターの認証情報を保存してください。

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

パラメーター	説明
API_KEY	コントロールプレーン API リクエストの認証に使用する API キーです。
clusterName	作成するクラスターの名前です。
projectId	クラスターを作成するプロジェクトの ID です。
regionId	クラスターを作成するクラウドリージョンの ID です。

接続

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

bash

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

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

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 (
    "context"

    "github.com/milvus-io/milvus/client/v3/milvusclient"
)

ctx := context.Background()

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

Rust

rust

use milvus::v2::prelude::*;

let config = ConnectConfig::new()
    .uri("YOUR_CLUSTER_ENDPOINT")
    .token("YOUR_CLUSTER_TOKEN");
let client = ClientV2::new(&config).await?;

C++

c++

#include <iostream>
#include "milvus/MilvusClientV2.h"

auto client = milvus::MilvusClientV2::Create();
auto status = client->Connect(milvus::ConnectParam("YOUR_CLUSTER_ENDPOINT").WithToken("YOUR_CLUSTER_TOKEN"));
if (!status.IsOk()) {
    std::cout << status.Message() << std::endl;
}

NodeJS

javascript

import { MilvusClient } from "@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/v2/vectordb/collections/list" \
  --header "Authorization: Bearer YOUR_CLUSTER_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"dbName": "default"}'

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

python

collections = client.list_collections()
print(collections)

管理

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

操作	Free クラスター	Serverless クラスター
名前の変更	サポートされています。	サポートされています。
再開	Free クラスターは、7 日間連続でアクティビティがないと自動的に一時停止され、いつでも再開できます。	Serverless クラスターは、一時停止および再開操作をサポートしていません。
デプロイメントオプションのアップグレード	Serverless または Dedicated にアップグレードできます。Free から Dedicated へのアップグレードでは、新しい Dedicated クラスターを作成し、Free クラスターからデータを移行します。	Dedicated にアップグレードできます。Serverless から Dedicated へのアップグレードでは、新しい Dedicated クラスターを作成し、Serverless クラスターからデータを移行します。
削除	サポートされています。Free クラスターは、削除後にリサイクルビンから復元できません。	サポートされています。

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

削除

プログラムからクラスターを削除するには、クラスター 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"