クラスターへの接続

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

📘注記

このページでは、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 コンソールから取得できます。対象クラスターの Cluster Details ページに移動します。Connect カードで、クラスターのパブリックエンドポイントをコピーしてください。

📘注記

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 クラスターへの接続​

接続の確認​

次のステップ​