Free & Serverless クラスター

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

Note

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

作成

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

Note

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

Free または Serverless クラスターは、Zilliz Cloud コンソールから作成できます。クラスターのステータスが 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"
    }'

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

接続

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

bash

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

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 });

CSharp

csharp

using Milvus.Client.V2;
using Milvus.Client.V2.Types;

const string CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT";
const string TOKEN = "YOUR_CLUSTER_TOKEN";

using var client = new MilvusClientV2(new ConnectConfig
{
    Uri = CLUSTER_ENDPOINT,
    ApiKey = TOKEN
});
await client.ConnectAsync();

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"