OpenSearch:スパースベクトルベースのクエリ

URL

/vector-service/query

• サンプル URL には、リクエストヘッダーのパラメーターやエンコード方式などの情報は含まれていません。

• サンプル URL には、OpenSearch インスタンスへの接続に使用するエンドポイントも含まれていません。

• 上記の URL に連結されているすべてのリクエストパラメーターの定義、使用方法、および値の例については、このトピックの「リクエストパラメーター」セクションをご参照ください。

プロトコル

HTTP

リクエストメソッド

POST

サポートされているフォーマット

JSON

リクエスト署名

次の表に示すパラメーターを使用して、リクエスト署名を計算できます。 リクエスト署名は、承認 ヘッダーに格納されます。

import com.aliyun.darabonba.encode.Encoder;
import com.aliyun.darabonbastring.Client;

public class GenerateAuthorization {

    public static void main(String[] args) throws Exception {
        String accessUserName = "username"; // ユーザー名
        String accessPassWord = "password"; // パスワード
        String realmStr = "" + accessUserName + ":" + accessPassWord + "";
        String authorization = Encoder.base64EncodeToString(Client.toBytes(realmStr, "UTF-8"));
        System.out.println(authorization);
    }
}

[authorization] ヘッダーの値の有効な形式:

cm9vdDp******mdhbA==

HTTP リクエストで [authorization] ヘッダーを指定する場合は、Basic プレフィックスを追加する必要があります。

例:

authorization: Basic cm9vdDp******mdhbA==

リクエストパラメーター

• SearchRequest

• SparseData

OpenSearch Vector Search Edition では、2 つの独立した複数値フィールドを使用して、スパースベクトルの添え字と値を表します。 2 つのフィールドの値の数は同じである必要があります。 2 つのフィールドの値の位置は 1 対 1 で対応しています。

たとえば、スパースベクトル (0, 0.5), (100, 0.9), (40, 0.3), (50, 0.7), (20, 0.6) が存在するとします。 次のコードは、スパースベクトルの複数値フィールドを示しています。

{
  "indices": [0, 100, 40, 50, 20], // インデックス
  "values": [0.5, 0.9, 0.3, 0.7, 0.6] // 値
}

データを書き込んだりクエリしたりする場合、添え字は昇順に配置する必要があり、値は添え字に基づいて調整する必要があります。 次のコードは、調整された複数値フィールドを示しています。

{
  "indices": [0, 20, 40, 50, 100], // インデックス (昇順)
  "values": [0.5, 0.6, 0.3, 0.7, 0.9] // 調整された値
}

クエリの重み

ハイブリッドクエリでは、同じドキュメントの最終スコアは、密ベクトルの距離とスパースベクトルの距離の合計です。 スパースベクトルと密ベクトルに異なる重みを構成する場合は、次のコードに基づいて構成を実行できます。

{
    "vector": [v * weight for v in dense_vector], # 密ベクトルに重みを適用
    "sparseData": {
        "indices": sparse_data["indices"],
        "values": [v * (1 - weight) for v in sparse_data["values"]] # スパースベクトルに重みを適用
    }
}

リクエストの例

{
    "tableName": "in0",
    "indexName": "vector",
    "vector": [
        0.1,
        0.2,
        0.3,
        0.4,
        0.5
    ],
    "sparseData": {
        "indices": [
            0,
            2
        ],
        "values": [
            1.2,
            2.4
        ]
    },
    "topK": 2,
    "order": "DESC"
}

レスポンスパラメーター

項目

例

{
    "totalCount": 50,
    "result": [
        {
            "id": 99,
            "score": 0.18588095903396607,
            "__source__": 1, // ソース
            "fields": {
                "content": "Zhonghao Cat 6 Network Cable RJ45 Cat 6 Gigabit 8-Core Twisted Pair Jumper Broadband Monitoring Home Network Cable Finished Cable" // コンテンツ
            }
        }
    ],
    "totalTime": 4.057
}