クラスターへの接続

アプリケーションで、スキーマ管理、insert、upsert、delete、search、query、hybrid search を含む完全なコレクション API が必要な場合は、Dedicated クラスターエンドポイントを使用します。

Note

このページでは、Dedicated サービングクラスターへの接続方法を説明します。Free または Serverless クラスターに接続する場合は、Free & Serverless クラスターを参照してください。プロジェクトエンドポイントでのオンデマンドコンピューティングについては、オンデマンド検索への接続を参照してください。

エンドポイント形式

クラスタータイプ	エンドポイントパターン	注記
Dedicated	`https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530`	Dedicated クラスターは、ポート `19530` のリアルタイムサービングエンドポイントを使用します。

事前準備

Dedicated クラスターに接続する前に、次の条件を満たしていることを確認してください。

BYOC プロジェクトをデプロイ済みであること。詳細については、以下を参照してください。
アプリケーションと BYOC プロジェクト内のクラスター間のネットワーク構成が完了していること。詳細については、クラスター接続の準備を参照してください。
クラスターを作成済みであること。
ユースケースに応じた Milvus SDK をインストール済みであること。詳細については、SDK のインストールを参照してください。
クラスターのパブリックエンドポイントを取得していること。
認証トークンを取得していること。これは、対象クラスターにアクセスできる API キー、または username:password 形式のクラスター認証情報のいずれかです。

クラスターのパブリックエンドポイントは Zilliz Cloud コンソールで確認できます。対象クラスターの クラスター Details ページに移動します。Connect カードで、クラスターのパブリックエンドポイントをコピーします。

Note

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

SDK のインストール

アプリケーションの言語に対応する SDK をインストールします。

bash

pip install pymilvus

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

Dedicated クラスターへの接続

SDK 間でクラスターエンドポイントとトークンを一貫して使用します。YOUR_CLUSTER_ENDPOINT はクラスターの Connect カードからコピーしたパブリックエンドポイント、YOUR_CLUSTER_TOKEN は対象クラスターにアクセスできる API キー、または username:password 形式のクラスター認証情報です。

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 で接続した後、コレクションの一覧取得などの軽量な操作を実行します。

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

次のステップ

接続後は、同じクライアントインスタンスを使用して、Dedicated クラスターに対してコレクションの作成、データのロード、リアルタイムの search または query 操作を実行します。

Free または Serverless のサービングクラスターについては、Free & Serverless クラスターを参照してください。プロジェクトエンドポイントでのオンデマンドコンピューティングについては、オンデマンド検索への接続を参照してください。

エンドポイント形式​

事前準備​

SDK のインストール​

Dedicated クラスターへの接続​

接続の確認​

次のステップ​