Serving Cluster への接続

Zilliz Cloud は、さまざまなビジネスニーズに対応するために、多様な serving cluster のデプロイオプションを提供します。

• Free: 学習や個人プロジェクトの出発点を提供しますが、ストレージ、vCU 消費量、collection 数に制限があります。

• Serverless: ワークロードに合わせて自動的にスケールする共有環境を提供します。リソースをプロビジョニングする必要はありません。このオプションは、予測不能またはスパイク状のトラフィックに対して、優れたコスト効率と伸縮性を実現します。

• Dedicated: 一貫性があり予測可能なパフォーマンスを要求する本番ワークロード向けに、分離された予約済み環境を提供します。このオプションは、継続的な高スループットと低レイテンシが重要なアプリケーションに最適です。

エンドポイント形式

Cluster type	Endpoint pattern	Notes
Free/Serverless	https://{cluster-id}.serverless.{region}.vectordb.zillizcloud.com	Free/Serverless cluster は、専用ポートなしのリアルタイム serving endpoint を使用します。
Dedicated	https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530	Dedicated cluster は、ポート 19530 付きのリアルタイム serving endpoint を使用します。

Free/Serverless cluster への接続

cluster 詳細ページの Connect カードから cluster public endpoint をコピーします。cluster へのアクセス権を持つ API key、または username:password 形式の cluster credential のいずれかを token として使用します。

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

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

python

collections = client.list_collections()
print(collections)

Dedicated cluster への接続

SDK 間で cluster endpoint と token を一貫して使用します。YOUR_CLUSTER_ENDPOINT は cluster の Connect カードからコピーした public endpoint であり、YOUR_CLUSTER_TOKEN は対象 cluster へのアクセス権を持つ API key、または username:password 形式の cluster credential のいずれかです。

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

接続の確認

SDK で接続した後、collection の一覧表示などの軽量な操作を実行します。

python

collections = client.list_collections()
print(collections)