すべてのプロダクト
Search
ドキュメントセンター

OpenSearch:プライマリキーに基づくクエリ

最終更新日:Aug 22, 2026

URL

/vector-service/fetch

  • この URL には、リクエストヘッダーまたはエンコードの詳細は含まれません。

  • この URL には、アプリケーションのホストアドレスは含まれません。

  • 上記の URL のクエリパラメーターの詳細については、後述の「クエリパラメーター」セクションをご参照ください。

リクエストプロトコル

HTTP

リクエストメソッド

POST

対応フォーマット

JSON

リクエスト署名

次の方法でリクエスト署名を計算できます。 リクエスト署名は Authorization ヘッダーに格納されます。

パラメーター

タイプ

説明

accessUserName

文字列

[インスタンスの詳細] ページ > [ネットワーク情報] でユーザー名を確認できます。

accessPassWord

文字列

[インスタンスの詳細] ページの [ネットワーク情報] セクションでパスワードを変更できます。

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==

リクエストボディの構文

パラメーター

説明

タイプ

必須

tableName

テーブル名。

文字列

はい

ids

ID のリスト。

list[文字列]

はい

指定したプライマリキーでデータをクエリする例:

{
    "tableName": "gist",
    "ids": [
        "1",
        "2",
        "3"
    ]
}

レスポンスパラメーター

フィールド名

説明

タイプ

result

返される結果。

list[Doc]

totalCount

結果数。

int

totalTime

レスポンスタイム。単位:ミリ秒。

float

errorCode

リクエストが失敗した場合に返されるエラーコード。

int

errorMsg

リクエストが失敗した場合に返されるエラーメッセージ。

文字列

Doc の定義

フィールド名

説明

タイプ

id

プライマリキーのフィールド。

データ型は、テーブルの作成時に指定します。

vector

ベクターフィールド。

list[float]

fields

ベクターの属性フィールド。

map<string, FieldType>

例:

{
    "result": [
        {
            "id": "1",
            "vector": [
                0.1,
                0.2,
                0.3
            ],
            "fields": {
                "a": 11
            }
        }
    ],
    "totalCount": 1,
    "totalTime": 1.2
}