semanticsimilaritydetailstable (Transact-SQL)

Se aplica a: SQL Server

Devuelve una tabla de cero, una o más filas de frases clave comunes en dos documentos (un documento de origen y un documento coincidente) cuyo contenido sea similar semánticamente.

Se puede hacer referencia a esta función de conjunto de filas en la cláusula FROM de una instrucción SELECT.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

table
Nombre de una tabla con indización de texto completo y semántica habilitada.

Este nombre puede ser un nombre de una a cuatro partes, pero no se permite un nombre de servidor remoto.

source_column
Nombre de la columna de la fila de origen que tiene el contenido cuya similitud se va a comparar.

source_key
Clave única que representa la fila del documento de origen.

Esta clave se convierte implícitamente al tipo de la clave única de texto completo en la tabla de origen siempre que sea posible. La clave se puede especificar como una constante o como una variable, pero no puede ser una expresión ni el resultado de una subconsulta escalar. Si se especifica una clave no válida, no se devuelve ninguna fila.

matched_column
Nombre de la columna de la fila coincidente que tiene el contenido cuya similitud se va a comparar.

matched_key
Clave única que representa la fila del documento coincidente.

Esta clave se convierte implícitamente al tipo de la clave única de texto completo en la tabla de origen siempre que sea posible. La clave se puede especificar como una constante o como una variable, pero no puede ser una expresión ni el resultado de una subconsulta escalar.

Tabla devuelta

En la tabla siguiente se describe la información sobre las frases clave que devuelve esta función de conjunto de filas.

Column_name	Tipo	Descripción
frase de clave	NVARCHAR	Frase clave que contribuye a la similitud entre el documento de origen y el documento coincidente.
score	REAL	Valor relativo de esta frase clave en su relación con todas las demás frases clave que son similares entre los dos documentos. El valor es un valor fraccionario decimal en el intervalo de [0.0, 1.0] donde una puntuación superior representa una ponderación mayor y 1.0 es la puntuación perfecta.

Notas generales

Para obtener más información, vea Buscar documentos similares y relacionados con la búsqueda semántica.

Metadatos

Para obtener información y estado sobre la extracción y el rellenado de similitud semánticos, consulte las siguientes vistas de administración dinámica:

• sys.dm_db_fts_index_physical_stats (Transact-SQL)

• sys.dm_fts_semantic_similarity_population (Transact-SQL)

Seguridad

Permisos

Necesita permisos SELECT en la tabla base en la que se crearon los índices semánticos y de texto completo.

Ejemplos

En el ejemplo siguiente se recuperan las 5 frases clave que tenían la puntuación de similitud más alta entre los candidatos especificados en la tabla HumanResources.JobCandidate de la AdventureWorks2022 base de datos de ejemplo. Las @CandidateId variables y @MatchedID representan valores de la columna de clave del índice de texto completo.

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;