メインコンテンツまでスキップ
バージョン: User Guides (Cloud)

オンデマンド DQL 運用
Public Preview

オンデマンドコンピューティングにおけるコレクションの DQL 運用（検索、クエリ、取得、ハイブリッド検索など）には、オンデマンドクラスタからコンピュートリソースをアタッチする必要があります。Zilliz Cloud では、オンデマンドコンピュートニーズに対応するためのセッションを作成できます。

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

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

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

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

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

client.has_collection(
    collection_name="my_collection"
)
const client = new MilvusClient({
    address: "https://{project-id}.{region}.vectordb.zillizcloud.com",
    token: "YOUR_API_KEY"
});

client.has_collection({
    collection_name: "my_collection"
});
export PROJECT_ENDPOINT='https://{project-id}.{region}.vectordb.zillizcloud.com'
export TOKEN="YOUR_API_KEY"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/collections/has" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "collectionName": "my_collection"
}'

セッションの作成​

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

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

📘Notes

RESTful API リクエストの場合、セッションを作成する代わりに、クラスター ID を DQL 呼び出しのクエリパラメーターとして渡す必要があります。

session = client.session(
    cluster_id="inxx-xxxxxxxxxxxxxxxxx"
)
const session = client.session("inxx-xxxxxxxxxxxxxxxxx");
export CLUSTER_ID="inxx-xxxxxxxxxxxxxxxxx"

DQL 操作の実行​

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

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"],
    search_params={"metric_type": "COSINE"}
)
const query_vector = [0.3580376395471989, -0.6023495712049978, 0.18414012509913835, -0.26286205330961354, ..., 0.9029438446296592];
const 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"],
});
curl --request POST \
--url "${PROJECT_ENDPOINT}/v2/vectordb/entities/search?cluster_id=inxx-xxxxxxxxxxxxxxxxx" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "dbName": "my_database",
    "collectionName": "my_collection",
    "data": [
        [
            0.3580376395471989,
            -0.6023495712049978,
            0.18414012509913835,
            -0.26286205330961354,
            0.9029438446296592
        ]
    ],
    "annsField": "vector",
    "limit": 3,
    "outputFields": [
        "product_id",
        "title",
        "main_category",
        "price",
        "average_rating",
        "rating_number"
    ]
}'

セッションを閉じる​

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

📘Notes

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

session.close()
session.close();