全部产品
Search
文档中心

OpenSearch:Kueri berdasarkan kunci utama

更新时间:Jun 26, 2025

URL

/vector-service/fetch

  • Contoh URL tidak mencakup informasi seperti header permintaan dan metode pengkodean.

  • Contoh URL juga tidak mencakup titik akhir yang digunakan untuk menghubungkan ke aplikasi OpenSearch.

  • Untuk informasi lebih lanjut tentang definisi, penggunaan, dan nilai contoh dari semua parameter permintaan yang digabungkan dalam URL di atas, lihat bagian "Parameter permintaan" dari topik ini.

Protokol

HTTP

Metode permintaan

POST

Format yang didukung

JSON

Tanda tangan permintaan

Gunakan metode berikut untuk menghitung tanda tangan permintaan. Tanda tangan permintaan disimpan di header authorization.

Parameter

Tipe

Deskripsi

accessUserName

string

Nama pengguna. Anda dapat melihat nama pengguna di tab API Endpoint pada halaman Detail Instance.

accessPassWord

string

Kata sandi. Anda dapat memodifikasi kata sandi di tab API Endpoint pada halaman Detail Instance.

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);
 }
}

Format valid untuk nilai header authorization:

cm9vdDp******mdhbA==

Tambahkan awalan Basic saat menentukan header authorization dalam permintaan HTTP.

Contoh:

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

Parameter permintaan

Parameter

Deskripsi

Tipe

Diperlukan

tableName

Nama tabel.

string

Ya

ids

ID.

list[string]

Ya

Contoh kueri data bidang kunci utama yang ditentukan:

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

Parameter respons

Parameter

Deskripsi

Tipe

result

Hasil yang dikembalikan.

list[Doc]

totalCount

Jumlah hasil.

int

totalTime

Waktu respons. Satuan: milidetik.

float

errorCode

Kode kesalahan yang dikembalikan jika permintaan gagal.

int

errorMsg

Pesan kesalahan yang dikembalikan jika permintaan gagal.

string

  • Doc

Parameter

Deskripsi

Tipe

id

Bidang kunci utama.

Tipe data ditentukan saat Anda membuat tabel.

vector

Bidang vektor.

list[float]

fields

Bidang atribut dari vektor.

map<string, FieldType>

Contoh:

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