semanticsimilaritytable (Transact-SQL)

適用於：SQL Server

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

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

Transact-SQL 語法慣例

語法

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 自變數所識別。

中繼資料

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

• sys.dm_db_fts_index_physical_stats (Transact-SQL)

• sys.dm_fts_semantic_similarity_population (Transact-SQL)

安全性

權限

需要建立全文檢索和語意索引之基表的 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;