此 FULLTEXTSCORE 函數會傳回 BM25 分數值，該值只能用於子句中 ORDER BY RANK ，以將結果從指定術語的最高相關性排序至最低相關性。
語法
FULLTEXTSCORE(<property_path>, <string_expr1>, <string_expr2>, ...)
Arguments
| Description | |
|---|---|
property_path |
要搜尋的屬性路徑。 |
string_expr1 |
要找到的第一個術語。 |
string_expr2 |
第二個要找的術語。 |
傳回類型
傳回可與 或 RRF搭配使用的 ORDER BY RANK BM25 評分。
範例
本節包含如何使用此查詢語言建構的範例。
全文分數與 ORDER BY RANK
在此範例中， FULLTEXTSCORE 函數用於 ORDER BY RANK 從最高相關性排序到最低相關性。
SELECT TOP 10 c.text
FROM c
ORDER BY RANK FULLTEXTSCORE(c.text, "keyword")
-- Example result not available (result not provided in markdown)
帶有 WHERE 和 ORDER BY RANK 的全文分數
在此範例中，函數 FULLTEXTSCORE 用於子句中 ORDER BY RANK ，並在 FULLTEXTCONTAINS 子句中使用 WHERE 。
SELECT TOP 10 c.text
FROM c
WHERE FULLTEXTCONTAINS(c.text, "keyword1")
ORDER BY RANK FULLTEXTSCORE(c.text, "keyword1", "keyword2")
-- Example result not available (result not provided in markdown)
備註
- 此功能需要註冊 Azure Cosmos DB NoSQL 全文檢索搜尋功能。
- 此功能需要全文索引。
- 此函式只能在子句中使用
ORDER BY RANK，或作為系統函式中的RRF引數。 - 此函式不能是投影的一部分 （例如，
SELECT FullTextScore(c.text, "keyword") AS Score FROM c無效）。