クラスターへの接続
この記事では、クラスターに接続するための体系的なガイドを提供します。
開始前に
続行する前に、以下の前提条件が満たされていることを確認してください。
-
BYOC プロジェクトをデプロイ済みであること。詳細については、以下を参照してください。
-
アプリケーションと BYOC プロジェクト内のクラスター間のネットワーク設定が完了していること。詳細については、BYOC クラスターへの接続準備 を参照してください。
-
クラスターを作成済みであること。詳細については、クラスターの作成 を参照してください。
-
ユースケースに適した Milvus SDK をインストール済みであること。詳細については、SDK のインストール を参照してください。
SDK よりも RESTful API の利用を検討している場合、継続的な接続を確立できないことを理解することが重要です。これは、HTTP プロトコルが単方向通信モードであることに起因します。
BYOC デプロイメントでは、クラスター認証情報 (username:password) を使用してクラスターに接続します。API キーはプラットフォーム API 操作用のみであり、データプレーン (Milvus SDK/クライアント) 接続には使用できません。
クラスターへの接続
クラスターが稼働したら、そのパブリックエンドポイントと認証トークンを使用して接続します。
-
クラスターのパブリックエンドポイント: これは Zilliz Cloud Web コンソールで取得できます。対象のクラスターのクラスターの詳細ページに移動します。接続カードで、クラスターのパブリックエンドポイントをコピーできます。

-
トークン: このトークンは、ユーザー名とパスワードのペアで構成される クラスター認証情報 です。
以下の例は、クラスターに接続する方法を示しています。
- Python
- Java
- NodeJS
- Go
- cURL
# Connect using a MilvusClient object
from pymilvus import MilvusClient
CLUSTER_ENDPOINT="YOUR_CLUSTER_ENDPOINT" # Set your cluster endpoint
TOKEN="YOUR_CLUSTER_TOKEN" # Set your token
# Initialize a MilvusClient instance
# Replace uri and token with your own
client = MilvusClient(
uri=CLUSTER_ENDPOINT, # Cluster endpoint obtained from the console
token=TOKEN # a colon-separated cluster username and password
)
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.client.ConnectConfig;
String CLUSTER_ENDPOINT = "YOUR_CLUSTER_ENDPOINT";
String TOKEN = "YOUR_CLUSTER_TOKEN";
// 1. Connect to Milvus server
ConnectConfig connectConfig = ConnectConfig.builder()
.uri(CLUSTER_ENDPOINT)
.token(TOKEN)
.build();
MilvusClientV2 client = new MilvusClientV2(connectConfig);
const { MilvusClient, DataType, sleep } = require("@zilliz/milvus2-sdk-node")
const address = "YOUR_CLUSTER_ENDPOINT"
const token = "YOUR_CLUSTER_TOKEN"
// 1. Connect to the cluster
const client = new MilvusClient({address, token})
import "github.com/milvus-io/milvus/client/v2/milvusclient"
client, err := milvusclient.New(ctx, &milvusclient.ClientConfig{
Address: "YOUR_CLUSTER_ENDPOINT",
APIKey: "YOUR_CLUSTER_TOKEN",
})
curl --request POST \
--url "YOUR_CLUSTER_ENDPOINT" \
--header "Authorization: Bearer YOUR_CLUSTER_TOKEN" \
--header "Content-Type: application/json" \
--data '{"dbName": "default"}'