query-vectors - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tam yetkilere sahiptir. Buna karşılık, RAM kullanıcıları ve RAM rollerinin herhangi bir izni yoktur; hesap sahibi veya yönetici tarafından bir RAM ilkesi veya paket ilkesi aracılığıyla erişim izni verilmelidir.

API	Eylem	Açıklama
QueryVectors	`oss:QueryVectors`	Vektör verilerini sorgular.

Komut biçimi

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

Parametreler

Parametre	Tür	Açıklama
--bucket	string	Vektör paketinin adı.
--index-name	string	Vektör dizininin adı.
--query-vector	string	JSON biçimindeki sorgu vektörü. Sorgu vektörünün boyutu, vektör dizininin boyutu ile aynı olmalıdır.
--top-k	int	Döndürülecek en benzer vektör sayısı. Geçerli değerler: 1–500.
--filter	string	Sorgu verilerini meta verilerle filtreler. Tek bir filtrenin maksimum uzunluğu: 20 KB Maksimum filtre talimatı sayısı: 1.024
--return-distance	/	Bu parametre boş bırakıldığında veya `true` olarak ayarlandığında benzerlik mesafesi döndürülür.
--return-metadata	/	Bu parametre boş bırakıldığında veya `true` olarak ayarlandığında meta veriler döndürülür.

Not

query-vectors komutu, QueryVectors API işlemine karşılık gelir.
Desteklenen genel komut satırı seçenekleri hakkında daha fazla bilgi için bkz. Genel komut satırı seçenekleri.

Filtre işleçleri

İşleç	Tür	Açıklama
`$eq`	Dize, Sayı, Boolean	Tam eşleşme (tek bir değer için). Dizi türündeki meta verilerde kullanıldığında, işleç değer dizideki herhangi bir öğeyle eşleşirse `true` döndürür.
`$ne`	Dize, Sayı, Boolean	Belirtilen değere eşit olmayan değerlerle eşleşir.
`$gt`	Sayı	Büyüktür.
`$gte`	Sayı	Büyük veya eşittir.
`$lt`	Sayı	Küçüktür.
`$lte`	Sayı	Küçük veya eşittir.
`$in`	Boş olmayan ilkel değer dizisi	Bir dizideki herhangi bir değerle eşleşir (SQL `IN` işlemine benzer)
`$nin`	Boş olmayan ilkel değer dizisi	Dizideki değerlerin hiçbiriyle eşleşmez (SQL `NOT IN` işlemine benzer).
`$exists`	Boolean	Bir meta veri anahtarının var olup olmadığını kontrol eder.
`$and`	Boş olmayan filtre dizisi	Bir dizi filtre koşulunda mantıksal AND işlemi uygular.
`$or`	Boş olmayan filtre dizisi	Bir dizi filtre koşulunda mantıksal OR işlemi uygular.
`$nor`	Boş olmayan filtre dizisi	Bir dizi filtre koşulunda mantıksal NOR işlemi uygular.

Filtre örnekleri

Aşağıda yaygın filtre ifade örnekleri yer almaktadır. İşleç belirtilmediğinde varsayılan olarak $eq kullanılır.

// Simple equality (uses $eq by default when the operator is omitted)
{"category": "finance"}

// Explicit equality / inequality
{"category": {"$eq": "finance"}}
{"category": {"$ne": "archived"}}

// Numeric comparison
{"created_year": {"$gt": 2023}}
{"created_year": {"$gte": 2024}}
{"created_year": {"$lt": 2026}}
{"created_year": {"$lte": 2025}}

// Array matching
{"language": {"$in": ["zh", "en"]}}
{"language": {"$nin": ["ja", "ko"]}}

// Existence check
{"author": {"$exists": true}}

// Logical combination
{"$and": [{"category": {"$eq": "finance"}}, {"created_year": {"$gte": 2024}}]}
{"$or": [{"category": {"$eq": "finance"}}, {"category": {"$eq": "tech"}}]}
{"$nor": [{"category": {"$eq": "finance"}}, {"category": {"$eq": "tech"}}]}

// Multiple conditions on the same field (range)
{"score": {"$gte": 0.6, "$lte": 0.95}}

Örnek

Aşağıdaki komut, 'examplebucket' vektör paketindeki 'index' vektör dizininde bulunan, bir sorgu vektörüne en benzer ve 'type' değeri 'comedy' veya 'documentary' olan ilk 10 vektörü bulur.

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