semanticsimilaritytable (Transact-SQL)

文章
08/11/2023

適用於：SQL Server

針對在指定資料行中的內容類別似指定之檔，傳回零、一或多個資料列的資料表。

您可以在 SELECT 陳述式的 FROM 子句中參考這個資料列集函數，就像是一般資料表名稱一樣。

語法

SEMANTICSIMILARITYTABLE  
    (  
    table,  
    { column | (column_list) | * },  
    source_key  
    )

引數

table
這是已啟用全文檢索和語意索引的資料表名稱。

此名稱可以是一到四個部分名稱，但不允許遠端伺服器名稱。

column
應該傳回結果的索引資料行名稱。資料行必須啟用語意索引。

column_list
表示數個數據行，以逗號分隔，並以括弧括住。所有資料行都必須啟用語意索引。

*
表示包含啟用語意索引的所有資料行。

source_key
資料列的唯一索引鍵，以要求特定資料列的結果。

金鑰會盡可能隱含地轉換成來源資料表中全文檢索唯一索引鍵的類型。索引鍵可以指定為常數或變數，但不能是運算式或純量子查詢的結果。

傳回的資料表

下表描述此資料列集函式傳回之類似或相關檔的相關資訊。

如果從多個資料行要求結果，則會根據每個資料行傳回相符的檔。

Column_name	類型	描述
source_column_id	int	來源文件用來尋找類似檔之資料行的識別碼。如需如何從column_id擷取資料行名稱的詳細資訊，請參閱 COL_NAME 和 COLUMNPROPERTY 函式。
matched_column_id	int	找到類似檔之資料行的識別碼。如需如何從column_id擷取資料行名稱的詳細資訊，請參閱 COL_NAME 和 COLUMNPROPERTY 函式。
matched_document_key	* 此索引鍵會比對來源資料表中唯一索引鍵的類型。	找到的檔或資料列的全文檢索和語意擷取唯一索引鍵值，與查詢中的指定檔類似。
得分	REAL	此檔與所有其他類似檔關聯性中相似性的相對值。此值是 [0.0， 1.0] 範圍內的小數十進位值，其中較高的分數代表更接近的相符專案，1.0 是完美的分數。

一般備註

如需詳細資訊，請參閱使用語意搜尋尋找類似和相關檔。

限制事項

您不能跨資料行查詢類似文件。 SEMANTICSIMILARITYTABLE 函式只會從與來源資料行相同的資料行擷取類似的檔，而來源資料行是由 source_key 引數所識別。

中繼資料

如需語意相似度擷取和母體的相關資訊和狀態，請查詢下列動態管理檢視：

安全性

權限

需要建立全文檢索和語意索引之基表的 SELECT 許可權。

範例

下列範例會從範例資料庫中的 HumanResources.JobCandidate 資料表 AdventureWorks2022 ，擷取前 10 名候選項目。

SELECT TOP(10) KEY_TBL.matched_document_key AS Candidate_ID  
FROM SEMANTICSIMILARITYTABLE  
    (  
    HumanResources.JobCandidate,  
    Resume,  
    @CandidateID  
    ) AS KEY_TBL  
ORDER BY KEY_TBL.score DESC;

分享方式：