Cluster への接続

アプリケーションでスキーマ管理、insert、upsert、delete、search、query、hybrid search を含む完全な Collection API が必要な場合は、Dedicated cluster endpoint を使用します。

📘Note

このページでは、Dedicated serving cluster への接続方法を示します。Free または Serverless cluster に接続するには、Free & Serverless Clusters を参照してください。project endpoint を介したオンデマンド compute については、Connect for On-Demand Search を参照してください。

Endpoint 形式

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

始める前に

Dedicated cluster に接続する前に、以下を確認してください。

Zilliz Cloud にアカウント登録していること。詳細は、Register with Zilliz Cloud を参照してください。
Dedicated cluster を作成していること。
ユースケースに対応する Milvus SDK をインストールしていること。詳細は、Install SDKs を参照してください。
cluster の public endpoint を取得していること。
認証 token を取得していること。これは、対象 cluster へアクセスできる API key、または username:password 形式の cluster credential を使用できます。

cluster の public endpoint は Zilliz Cloud コンソールから取得できます。対象 cluster の Cluster Details ページに移動し、Connect カードで cluster の public endpoint をコピーします。

📘Note

SDK ではなく RESTful API を使用する場合、HTTP はリクエスト・レスポンス通信モデルに従うため、継続的な接続は確立されません。

SDK のインストール

アプリケーション言語向けの SDK をインストールします。

bash

pip install pymilvus

Java、Node.js、Go のプロジェクトでは、以下の例を使用する前に、対応する Milvus SDK をプロジェクトにインストールしてください。

Dedicated cluster への接続

cluster endpoint と token は、各 SDK で一貫して使用してください。YOUR_CLUSTER_ENDPOINT は cluster の Connect カードからコピーした public endpoint、YOUR_CLUSTER_TOKEN は対象 cluster へアクセスできる API key、または username:password 形式の cluster credential です。

Python
Java
Go
NodeJS
cURL

python
from pymilvus import MilvusClient

CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT"
TOKEN = "YOUR_CLUSTER_TOKEN"

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

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
import "github.com/milvus-io/milvus/client/v2/milvusclient"

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

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

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

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

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)

次のステップ

接続後は、同じ client インスタンスを使用して collection を作成し、データをロードし、Dedicated cluster に対してリアルタイムの search または query 操作を実行できます。

Free または Serverless serving cluster については、Free & Serverless Clusters を参照してください。project endpoint を介したオンデマンド compute については、Connect for On-Demand Search を参照してください。

Endpoint 形式​

始める前に​

SDK のインストール​

Dedicated cluster への接続​

接続の確認​

次のステップ​