semanticsimilaritydetailstable (Transact-SQL)

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 como un nombre de tabla normal.

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.

Nombre de columna	Tipo	Descripción
keyphrase	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.

Comentarios 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

Se requieren permisos SELECT en la tabla base en 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 máxima puntuación de similitud entre los candidatos especificados en la tabla HumanResources.JobCandidate de la base de datos de ejemplo AdventureWorks2012. Las variables @CandidateId y @MatchedID representan valores de la columna de clave de í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;