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

オンデマンド検索のための接続

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

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