メインコンテンツまでスキップ

Free & Serverless クラスター

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

📘注

Dedicated クラスターについては、Dedicated Cluster を参照してください。プロジェクトエンドポイントを介したオンデマンド検索については、Connect for On-Demand Search を参照してください。

Create​

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

📘注

各 organization では、作成できる Free クラスターは 1 つのみです。追加の serving クラスターが必要な場合は、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コントロールプレーン API リクエストの認証に使用する API key。
clusterName作成するクラスターの名前。
projectIdクラスターを作成する project の ID。
regionIdクラスターを作成するクラウドリージョンの ID。

Connect​

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

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

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

python
from pymilvus import MilvusClient

CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT"
TOKEN = "YOUR_CLUSTER_TOKEN"

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

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

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

Manage​

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

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

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

Drop​

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