Aracılığıyla paylaş


VectorDistance (NoSQL sorgusu)

UYGULANANLAR: NoSQL

Belirtilen iki vektör arasındaki benzerlik puanını döndürür.

Not

Daha fazla bilgi için bkz . Jeo-uzamsal ve GeoJSON konum verileri.

Söz dizimi

VECTORDISTANCE(<vector_expr1>, <vector_expr2>, [<bool_expr>], [<obj_expr>])  

Bağımsız değişkenler

Açıklama
spatial_expr_1 Veya daha küçük bir float32 dizi.
spatial_expr_2 Veya daha küçük bir float32 dizi.
bool_expr Order BY ifadesinde hesaplanan değerin nasıl kullanıldığını belirten boole değeri. ise truedeneme yanılma kuvveti kullanılır. değeri false , varsa vector özelliğinde tanımlanan tüm dizinlerden yararlanıyor. Varsayılan değer false olarak belirlenmiştir.
obj_expr Vektör uzaklığı hesaplama seçeneklerini belirtmek için kullanılan JSON biçimli nesne değişmez değeri. Geçerli öğeler ve öğelerini içerir distanceFunction dataType.
distanceFunction Uzaklığı/benzerliği hesaplamak için kullanılan ölçüm.
dataType Vektörlerin veri türü. float32, int8, uint8 değerleri. Varsayılan değer float32 olarak belirlenmiştir.

için distanceFunction desteklenen ölçümler şunlardır:

Dönüş türleri

İki ifade arasındaki benzerlik puanını numaralandıran sayısal bir ifade döndürür.

Örnekler

Gerekli bağımsız değişkenlerle

SELECT c.name, VectorDistance(c.vector1, c.vector2) AS SimilarityScore
FROM c
ORDER BY VectorDistance(c.vector1, c.vector2)

İsteğe bağlı bağımsız değişkenlerle

SELECT c.name, VectorDistance(c.vector1, c.vector2, true, {'distanceFunction':'cosine', 'dataType':'float32',}) AS SimilarityScore
FROM c
ORDER BY VectorDistance(c.vector1, c.vector2)

Açıklamalar

  • Bu işlev, Azure Cosmos DB NoSQL Vektör Araması önizleme özelliğine kaydolmayı gerektirir.
  • Bu işlev vektör dizininden yararlanır
  • isteğe bağlı bool_exprolarak verilirsefalse, varsa yolda tanımlanan vektör dizini kullanılır. Vektör yolunda hiçbir dizin tanımlanmamışsa, bu tam taramaya geri döner ve vektör dizini kullanıldığından daha yüksek RU ücretleri ve daha yüksek gecikme süresine neden olur.
  • VectorDistance Bir ORDER BY yan tümcede kullanıldığında, sonuçlar her zaman kullanılan benzerlik ölçümüne göre en benzer (ilk) ile en az benzer (son) sıralandığından için yönün belirtilmesi ORDER BY gerekmez.
  • Sonuç, benzerlik puanı olarak ifade edilir.