クラスターへの接続
Contact Sales to Enable BYOC

この記事では、クラスターへの接続方法について体系的に解説します。

開始前の準備

作業を進める前に、以下の前提条件が満たされていることを確認してください。

BYOC プロジェクトをデプロイしていること。詳細については、以下を参照してください。
アプリケーションと BYOC プロジェクト内のクラスター間のネットワーク設定が完了していること。詳細については、BYOC クラスターへの接続を参照してください。
クラスターを作成していること。詳細については、クラスターの作成を参照してください。
ユースケースに適用可能な Milvus SDK をインストールしていること。詳細については、SDK のインストールを参照してください。

📘Note

SDK ではなく RESTful API を使用する場合、継続的な接続を確立することはできません。これは、HTTP プロトコルの一方向通信モードによるものです。

BYOC デプロイメントでは、クラスター認証情報（username:password）を使用してクラスターに接続します。API キーは Platform 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"}'

開始前の準備​

クラスターへの接続​

開始前の準備

クラスターへの接続