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

クエリ (V2)

Milvus バージョンの互換性
サーバーサイドのソート、グループ化、および検索集約のパラメータ（orderByFields、groupByFields、searchAggregation）は、Milvus v3.0.x 以降と互換性のあるクラスターでのみ有効です。Zilliz Cloud では、サーバーレスクラスタは Milvus v3.0.x と互換性があり、Dedicated クラスタは v3.0.x Public Preview にアップグレードしない限り Milvus v2.6.x と互換性があります。

この操作は、指定されたブール式を使用してスカラー フィールドのフィルタリングを実行します。

POST/v2/vectordb/entities/query
接続エンドポイント

https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530

📘ノート
  • サービングクラスターを使用している場合は、クラスターエンドポイントを使用してください。

    • Free & Serverless

      https://{cluster-id}.serverless.{region}.vectordb.zillizcloud.com

    • Dedicated

      https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530

  • ${CLUSTER_ENDPOINT} を、あなたのZilliz Cloudクラスターのエンドポイントに置き換える必要があります。
  • エンドポイントを取得するには、Describe Cluster V2 APIを使用してレスポンスから値を抽出してください。
shell
export CLUSTER_ENDPOINT="https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530"
パラメータ
Authorizationstringheader

認証トークンは、適切な権限を持つ API key またはusername:password のようにコロンで結合した username と password の組み合わせである必要があります。project endpoint を使用している場合は、十分な権限を持つ有効な API key のみが使用できます。

値の例： Bearer {{TOKEN}}
リクエスト・ボディapplication/json
dbNamestring

データベースの名前。

collectionNamestring必要

この操作が適用される collection の名前。

filterstring

検索の一致項目を見つけるために使用するフィルター。

outputFieldsarray

クエリ結果とともに返すフィールドの配列。

[]outputFieldsstring

出力フィールド名。

partitionNamesarray

この操作が適用される partition の名前です。このパラメーターを設定すると、操作は指定された partition に制限されます。設定しない場合、操作は collection 内のすべての partition に適用されます。

[]partitionNamesstring

partition 名。

limitinteger

返される entity の総数。 このパラメーターは、param 内の offset と組み合わせて使用することで、ページネーションを有効にできます。 この値と param 内の offset の合計は 16,384 未満である必要があります。

offsetinteger

検索結果でスキップするレコード数。 このパラメーターは、limit と組み合わせて使用することで、ページネーションを有効にできます。 この値と limit の合計は 16,384 未満である必要があります。

exprParamsobject

パラメーター化された filter 式の式テンプレート パラメーター値。

consistencyLevelstring

整合性レベル。指定可能な値は Strong、Session、Bounded、Eventually です。

orderByFieldsarray

クエリ結果の並べ替えに使用するスカラーフィールドです。各項目には、フィールド名、fieldName:asc、fieldName:desc のいずれかを指定できます。デフォルトの並べ替え方向は昇順です。

[]orderByFieldsstringPublic Preview

スカラーフィールドとオプションの並べ替え方向。

値の例： word_count:desc
groupByFieldsarray

クエリ結果をグループ化するために使用するフィールド名。各要素は 1 つのグループ化フィールドを表します。

[]groupByFieldsstringPublic Preview

クエリ結果のグループ化に使用する 1 つのフィールド名。

bash
export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/entities/query" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "collectionName": "quick_setup",
    "filter": "color like \"red_%\"",
    "outputFields": [
        "color"
    ],
    "limit": 3,
    "orderByFields": [
        "color:asc"
    ]
}'
レスポンス200 OK - application/json

辞書のリスト。各辞書はクエリされた entity を表します。

クエリオペレーションが返す可能性があるレスポンスペイロードの形式の 1 つ。

codeinteger

レスポンス コード。

costinteger

この操作のコスト。これは free cluster と serverless cluster にのみ適用され、現在のリクエストの vCU 使用量を示します。

dataarray

辞書のリスト。各辞書はクエリされた entity を表します。

[]dataobject

entity オブジェクト

idoneOf

返されたエンティティのプライマリキーの値。Milvus のプライマリキーは Collection のスキーマに応じて Int64 または VarChar のため、値は数値または文字列のいずれかです。

integer
(近日追加予定)
string
(近日追加予定)
grpstring

groupingField を指定した場合に返される、この結果が属するグループ。

count(*)number

グループの集計カウント。件数のみのグループ別クエリ実行時に返されます。

scanned_remote_bytesinteger

デプロイメントで tiered storage を使用し、usage tracking が有効になっていて、この操作が remote/disk storage から読み取る場合に返されます。すべてのデータが local cache から提供される場合は省略されます。

scanned_total_bytesinteger

デプロイメントで tiered storage を使用し、usage tracking が有効になっていて、この操作が remote/disk storage から読み取る場合に返されます。すべてのデータが local cache から提供される場合は省略されます。

cache_hit_rationumber

デプロイメントで tiered storage を使用し、usage tracking が有効になっていて、この操作が remote/disk storage から読み取る場合に返されます。すべてのデータが local cache から提供される場合は省略されます。

エラー メッセージを返します。

codeinteger

レスポンス コード。

messagestring

エラー メッセージ。

Successjson
{
    "code": 0,
    "cost": 0,
    "data": [
        {
            "color": "red_7025",
            "id": 1
        },
        {
            "color": "red_4794",
            "id": 4
        },
        {
            "color": "red_9392",
            "id": 6
        }
    ]
}
Ctrl I