All Products
Search
Document Center

Object Storage Service:query-vectors

Last Updated:Mar 26, 2026

Gunakan perintah query-vectors untuk melakukan pencarian kemiripan vektor.

Permissions

Secara default, Akun Alibaba Cloud memiliki semua izin, sedangkan Pengguna RAM dan Peran RAM tidak memiliki izin apa pun. Pemilik akun atau administrator harus memberikan izin melalui RAM policy atau bucket policy.

API

Action

Description

QueryVectors

oss:QueryVectors

Kueri 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.

--query-vector

string

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

--top-k

int

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

--filter

string

Memfilter hasil kueri berdasarkan metadata.

  • Panjang maksimum: 64 KB per permintaan.

  • Maksimal 1.024 instruksi filter per permintaan.

--return-distance

/

Jarak kemiripan dikembalikan jika Anda mengosongkan parameter ini atau menyetelnya ke true.

--return-metadata

/

Menentukan apakah metadata dikembalikan. Jika Anda tidak menentukan parameter ini atau menyetelnya ke true, metadata akan dikembalikan.

Catatan

Filter operators

Operator

Type

Description

$eq

String

Sesuai dengan satu nilai. Jika bidang metadata berupa array, operator ini cocok dengan elemen apa pun dalam array tersebut.

$ne

String

Tidak sama dengan.

$in

String array

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

$nin

String array

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

$exists

Boolean

Memeriksa apakah kunci metadata ada.

$and

Array filter tidak kosong

Menjalankan operasi logika AND pada array yang terdiri dari dua ekspresi filter atau lebih.

$or

Array filter tidak kosong

Menjalankan operasi logika OR pada array yang terdiri dari dua ekspresi filter atau lebih.

Examples

Contoh ini menemukan 10 vektor teratas yang paling mirip dengan vektor kueri. Pencarian ditujukan ke indeks vektor 'index' dalam bucket vektor 'examplebucket' dan memfilter vektor berdasarkan tipe "comedy" dan "documentary".

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