クラスターへの接続

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

Note

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

エンドポイント形式

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

事前準備

Dedicated クラスターに接続する前に、以下を確認してください。

Zilliz Cloud にアカウントを登録していること。詳細については、Zilliz Cloud への登録を参照してください。
Dedicated クラスターを作成していること。
ユースケースに合った 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 の serving クラスターについては、Free & Serverless クラスターを参照してください。プロジェクトエンドポイントを介したオンデマンドコンピュートについては、オンデマンド検索のための接続を参照してください。

エンドポイント形式​

事前準備​

SDK のインストール​

Dedicated クラスターへの接続​

接続の確認​

次のステップ​