VectorDistance (consulta NoSQL)
APLICA-SE A: NoSQL
Retorna a pontuação de similaridade entre dois vetores especificados.
Observação
Para obter mais informações, confira os Dados de localização Geoespacial e GeoJSON.
Sintaxe
VectorDistance(<vector_expr1>, <vector_expr2>, [<bool_expr>], [<obj_expr>])
Argumentos
Descrição | |
---|---|
spatial_expr_1 |
Uma matriz de float32 ou menor. |
spatial_expr_2 |
Uma matriz de float32 ou menor. |
bool_expr |
Um booliano que especifica como o valor computado é usado em uma expressão ORDER BY. Se true , a força bruta será usada. Um valor de false usa qualquer índice definido na propriedade vector, se ele existir. O valor padrão é false . |
obj_expr |
Um literal de objeto formatado JSON usado para especificar opções para o cálculo de distância de vetor. Os itens válidos incluem distanceFunction e dataType . |
distanceFunction |
A métrica usada para calcular a distância/similaridade. |
dataType |
O tipo de dados dos vetores. float32 , int8 , uint8 valores. O valor padrão é float32 . |
As métricas distanceFunction
suportadas são:
cosine
, que tem valores de-1
(menos semelhante) a+1
(mais semelhante).dotproduct
, que tem valores de-∞
(-inf
) (menos semelhante) a+∞
(+inf
) (mais semelhante).euclidean
, que tem valores de0
(mais semelhante) a+∞
(+inf
) (menos semelhante).
Tipos de retorno
Retorna uma expressão numérica que enumera a pontuação de similaridade entre duas expressões.
Exemplos
Este primeiro exemplo inclui apenas os argumentos necessários.
SELECT VALUE {
name: s.name,
similarityScore: VectorDistance(s.vector1, s.vector2)
}
FROM
source s
ORDER BY
VectorDistance(s.vector1, s.vector2)
Este próximo exemplo também inclui argumentos opcionais.
SELECT VALUE {
name: s.name,
similarityScore: VectorDistance(s.vector1, s.vector2, true, {'distanceFunction':'cosine', 'dataType':'float32',})
}
FROM
source s
ORDER BY
VectorDistance(s.vector1, s.vector2)
Comentários
- Essa função requer o registro na versão prévia do recurso de Busca em Vetores NoSQL do Azure Cosmos DB.
- Essa função do sistema se beneficia de um índice de vetor
- se
false
for fornecido como obool_expr
opcional, o índice de vetor definido no caminho será usado, se houver. Se nenhum índice for definido no caminho do vetor, essa função será revertida para a verificação completa e incorrerá em cobranças de RU mais altas e latência mais alta do que se estiver usando um índice de vetor. - Quando
VectorDistance
é usado em umaORDER BY
cláusula, nenhuma direção precisa ser especificada para oORDER BY
como os resultados são sempre classificados na ordem do mais semelhante (primeiro) para o menos semelhante (último) com base na métrica de similaridade usada. - O resultado é expresso como uma pontuação de similaridade.