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

オンデマンド DQL 操作

オンデマンドコンピューティング向けのコレクションでの DQL 操作（search、query、get、ハイブリッド検索など）では、オンデマンドクラスターのコンピュートリソースをアタッチする必要があります。Zilliz Cloud では、セッションを作成してオンデマンドコンピューティングのニーズを満たすことができます。

この記事では、プロジェクトエンドポイントを使用してデータベースにコレクションを作成済みであることを前提としています。詳細については、外部コレクションの作成 を参照してください。

project endpoint に接続する​

プロジェクトエンドポイントは、オンデマンドコンピュートリソースへのアクセスを提供するために設計されています。これを使用して、オンデマンドクラスターとデータベースを管理できるほか、コレクションに格納されたデータを操作できます。

以下のコード例では、デフォルトのデータベースに my_collection という名前の外部コレクションがあることを前提としています。また、接続を設定する際には、十分な権限を持つ有効な API キーを常に使用してください。

python
client = MilvusClient(
    uri="https://{project-id}.{region}.vectordb.zillizcloud.com",
    token="YOUR_API_KEY"
)

client.has_collection(
    collection_name="my_collection"
)

セッションを作成する​

プロジェクトエンドポイントへの接続を設定したら、指定したオンデマンドクラスターのコンピュートリソースをアタッチするためのセッションを作成します。

以下の例では、ID が inxx-xxxxxxxxxxxxxxxxx のオンデマンドクラスターをすでに作成済みであることを前提としています。

Notes

RESTful リクエストの場合、セッションを作成する代わりに、クラスター ID をクエリパラメーターとして DQL 呼び出しに渡してください。

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

DQL 操作を実行する​

セッションの準備ができたら、検索を実行できます。以下の例では、基本的なベクトル検索を例として使用しています。これは、query、get、およびハイブリッド検索にも適用されます。

python
query_vector = [0.3580376395471989, -0.6023495712049978, 0.18414012509913835, -0.26286205330961354, ..., 0.9029438446296592]
res = session.search(
    db_name="my_database",
    collection_name="my_collection",
    anns_field="vector",
    data=[query_vector],
    limit=3,
    output_fields=["product_id", "title", "main_category", "price", "average_rating", "rating_number"]
)

セッションを閉じる​

オンデマンドコンピューティングのタスクが完了したら、セッションを閉じることができます。閉じられたセッションは、その後の DQL 操作には使用できません。

Notes

RESTful 呼び出しでは、これは不要です。

python
session.close()
Ctrl I