Object Storage Service:QueryVectors

権限

デフォルトでは、Alibaba Cloud アカウント (root ユーザー) はすべての権限を持ちますが、その RAM ユーザーおよび RAM ロールには権限が付与されていません。権限を付与するには、Alibaba Cloud アカウントの所有者または管理者が RAM ポリシー または バケットポリシー を使用する必要があります。

リクエスト構文

ベクトルインデックスを作成した直後の最初の 30 秒間は、QueryVectors の取得率が低くなります。PutVectors を使用してデータを書き込んだ後、約 2～3 秒で QueryVectors によるクエリが可能になります。

POST /?queryVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Content-type: application/json

{
   "filter": {
       "$and": [{
           "type": {
               "$in": ["comedy", "documentary"]
           }
       }, {
           "year": {
               "$eq": "2020"
           }
       }]
    },
   "indexName": "string",
   "queryVector": {
       "float32":[float]
    },
   "returnDistance": boolean,
   "returnMetadata": boolean,
   "topK": int
}

リクエストヘッダー

この操作では、共通のリクエストヘッダーのみを使用します。詳細については、「共通の HTTP ヘッダー」をご参照ください。

リクエストパラメーター

レスポンスヘッダー

この操作では、共通のレスポンスヘッダーのみを使用します。詳細については、「共通の HTTP ヘッダー」をご参照ください。

レスポンス要素

例

POST /?queryVectors HTTP/1.1
Host: examplebucket-123***456.cn-hangzhou.oss-vectors.aliyuncs.com
Date: Thu, 17 Apr 2025 01:33:47 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218
Content-type: application/json

{
   "filter": {
       "$and": [{
           "category": {
               "$in": ["technology", "science"]
           }
       }, {
           "year": {
               "$eq": "2020"
           }
       }]
    },
   "indexName": "vectorindex1",
   "queryVector": {
       "float32": [0.15, 0.25, 0.35, 0.45, 0.55]
    },
   "returnDistance": true,
   "returnMetadata": true,
   "topK": 5
}

応答の例

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906****
Date: Thu, 17 Apr 2025 01:33:47 GMT
Connection: keep-alive
Server: AliyunOSS
Content-type: application/json

{
   "vectors": [ 
      { 
         "distance": 0.12,
         "key": "doc-001",
         "metadata": {
             "category": ["technology", "ai"],
             "title": "ベクトル検索の概要",
             "year": "2020"
         }
      },
      { 
         "distance": 0.25,
         "key": "doc-003",
         "metadata": {
             "category": ["science"],
             "title": "高度なベクトル操作",
             "year": "2020"
         }
      }
   ]
}

SDK

QueryVectors 操作は、以下の SDK で利用可能です：

• ベクトルの取得（Python SDK V2）

• ベクトルの取得（Go SDK V2）

ossutil CLI

QueryVectors 操作に対応する ossutil コマンドは、query-vectors です。

エラーコード