メインコンテンツまでスキップ

オンデマンド検索への接続

オンデマンドクラスターのコンピュートリソースを使用して、オンデマンド検索やクエリワークロードを実行する場合は、プロジェクトエンドポイントを使用します。

📘Note

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

エンドポイントの形式​

エンドポイントの種類エンドポイントのパターン用途
プロジェクトエンドポイントhttps://{project-id}.{region}.api.zillizcloud.comオンデマンドクラスター経由でのデータインポート、バッチ検索、クエリ、取得、検索、およびハイブリッド検索。

始める前に​

  • Zilliz Cloud コンソールからプロジェクトエンドポイントを取得します。

  • 検索ワークロードにコンピュートリソースを提供するオンデマンドクラスターの ID を取得します。

  • プロジェクトおよび対象データに対して十分な権限を持つ API キーを作成します。

  • ユースケースに合わせて Milvus SDK をインストールします。詳細については、「SDK のインストール」を参照してください。

プロジェクトエンドポイントへの接続​

プロジェクトエンドポイントを使用して MilvusClient を作成し、リクエストを処理するオンデマンドクラスターを指定します。

python
from pymilvus import MilvusClient

client = MilvusClient(
    uri="https://{project-id}.{region}.api.zillizcloud.com",
    cluster="inxx-xxxxxxxxxxxxxxx",
    token="YOUR_API_KEY",
)

検索セッションの作成​

セッションオブジェクトを使用して、操作をオンデマンドクラスターに紐付けます。

python
session = client.session(cluster_id="inxx-xxxxxxxxxxxxxxx")

その後、セッションを使用して query、get、search、hybrid_search などの DQL 操作を実行します。

python
results = session.search(
    collection_name="my_collection",
    data=[[0.1, 0.2, 0.3, 0.4]],
    anns_field="vector",
    limit=10,
)

print(results)

認証​

プロジェクトエンドポイントに接続する際は、有効な API キーを認証トークンとして使用します。

username:password 形式のクラスター認証情報は、サービングクラスターエンドポイント専用です。プロジェクトエンドポイント経由でオンデマンド検索を行う場合は、必要なプロジェクト権限を持つ API キーを使用してください。

この接続方法の使用場面​

バッチ処理、探索、検証、実験など、常時稼働のサービングよりもオンデマンドコンピュートが適しているワークロードには、プロジェクトエンドポイントを使用します。

本番アプリケーションで完全なコレクション API と常時稼働の低レイテンシーサービングが必要な場合は、代わりに Free、Serverless、または Dedicated サービングクラスターに接続してください。サービングクラスターのエンドポイント形式と接続例については、「サービングクラスターへの接続」を参照してください。

Ctrl I