semanticsimilaritydetailstable (Transact-SQL)

适用于：SQL Server

返回一个表，该表包含其内容在语义上相似的两个文档（源文档和匹配的文档）共有的关键短语的零个、一个或多个行。

可以在 SELECT 语句的 FROM 子句中引用此行集函数

Transact-SQL 语法约定

语法

SEMANTICSIMILARITYDETAILSTABLE  
    (  
    table,  
    source_column,  
    source_key,  
    matched_column,  
    matched_key  
    )  

参数

table
启用全文和语义索引的表的名称。

此名称可由 1 到 4 个部分组成，但不允许使用远程服务器名称。

source_column
源行中包含要比较相似性的内容的列的名称。

source_key
表示源文档的行的唯一键。

此键将尽可能隐式转换为源表中的全文唯一键的类型。 可以将此键指定为一个常量或变量，但不能是表达式或标量子查询的结果。 如果指定了无效键，则不返回任何行。

matched_column
匹配的行中包含要比较相似性的内容的列的名称。

matched_key
表示匹配文档的行的唯一键。

此键将尽可能隐式转换为源表中的全文唯一键的类型。 可以将此键指定为一个常量或变量，但不能是表达式或标量子查询的结果。

返回的表

下表介绍此行集函数返回的关键短语的信息。

Column_name	类型	描述
keyphrase	NVARCHAR	在源文档和匹配文档之间促进相似性的关键短语。
score	REAL	一个相对值，用来表示此关键短语与两篇文档间相似的所有其他关键短语的关系。 该值是范围 [0.0, 1.0] 中的小数值，较高的得分表示较高权重，1.0 是最理想的得分。

一般备注

有关详细信息，请参阅 使用语义搜索查找相似和相关文档。

元数据

有关语义相似性的提取和填充的信息和状态，请查询以下动态管理视图：

• sys.dm_db_fts_index_physical_stats (Transact-SQL)

• sys.dm_fts_semantic_similarity_population (Transact-SQL)

安全性

权限

需要对创建全文和语义搜索所基于的基表具有 SELECT 权限。

示例

以下示例检索示例数据库的 HumanResources.JobCandidate 表中AdventureWorks2022指定候选项之间具有最高相似性分数的 5 个关键短语。 变量@CandidateId@MatchedID表示全文索引键列中的值。

SELECT TOP(5) KEY_TBL.keyphrase, KEY_TBL.score  
FROMSEMANTICSIMILARITYDETAILSTABLE  
    (  
    HumanResources.JobCandidate,  
    Resume, @CandidateID,  
    Resume, @MatchedID  
    ) AS KEY_TBL  
ORDER BY KEY_TBL.score DESC;