All Products
Search

This Product

    Object Storage Service:query-vectors

    Document Center

    Object Storage Service:query-vectors

    Last Updated:Jun 27, 2026

    Gunakan perintah query-vectors untuk melakukan pencarian kemiripan vektor.

    Permissions

    Secara default, Akun Alibaba Cloud memiliki izin penuh. Sebaliknya, Pengguna RAM dan Peran RAM tidak memiliki izin apa pun dan harus diberikan akses oleh pemilik akun atau administrator melalui RAM policy atau bucket policy.

    API

    Action

    Description

    QueryVectors

    oss:QueryVectors

    Menanyakan data vektor.

    Command format

    ossutil vectors-api query-vectors --bucket value --index-name value --query-vector value --top-k value  [flags]

    Parameters

    Parameter

    Type

    Description

    --bucket

    string

    Nama bucket vektor.

    --index-name

    string

    Nama indeks vektor.

    --query-vector

    string

    Vektor kueri dalam format JSON. Dimensi vektor kueri harus sama dengan dimensi indeks vektor.

    --top-k

    int

    Jumlah vektor paling mirip yang akan dikembalikan. Nilai yang valid: 1–500.

    --filter

    string

    Memfilter data kueri berdasarkan metadata.

    • Panjang maksimum satu filter: 20 KB

    • Jumlah maksimum instruksi filter: 1.024

    --return-distance

    /

    Jarak kemiripan dikembalikan jika parameter ini dikosongkan atau diatur ke true.

    --return-metadata

    /

    Metadata dikembalikan jika parameter ini dikosongkan atau diatur ke true.

    Catatan

    Filter operators

    Operator

    Type

    Description

    $eq

    String

    Saat digunakan pada metadata bertipe array, operator ini mengembalikan true jika nilainya sesuai dengan salah satu elemen dalam array.

    $ne

    String

    Mencocokkan nilai yang tidak sama dengan nilai yang ditentukan.

    $gt

    Number

    Lebih besar dari.

    $gte

    Number

    Lebih besar dari atau sama dengan.

    $lt

    Number

    Kurang dari.

    $lte

    Number

    Kurang dari atau sama dengan.

    $in

    String array

    Mencocokkan nilai apa pun dalam array (mirip dengan operasi SQL IN).

    $nin

    String array

    Tidak mencocokkan nilai apa pun dalam array (mirip dengan operasi SQL NOT IN).

    $exists

    Boolean

    Memeriksa apakah kunci metadata ada.

    $and

    Non-empty array of filters

    Menjalankan operasi logika AND pada array kondisi filter.

    $or

    Non-empty array of filters

    Menjalankan operasi logika OR pada array kondisi filter.

    Example

    Perintah berikut menemukan 10 vektor teratas dalam indeks vektor 'index' pada bucket vektor 'examplebucket' yang paling mirip dengan vektor kueri dan memiliki tag 'type' bernilai 'comedy' atau 'documentary'.

    ossutil vectors-api query-vectors --bucket examplebucket --index-name index --filter "{\"$and\":[{\"type\":{\"$in\":[\"comedy\",\"documentary\"]}}]}" --query-vector "{\"float32\":[32]}" --top-k 10