Compartir por

semánticosimilaridad (Transact-SQL)

Se aplica a:SQL Server

Devuelve una tabla de cero, una o más filas para los documentos cuyo contenido de las columnas especificadas sea similar semánticamente a un documento indicado.

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

Convenciones de sintaxis de Transact-SQL

Syntax

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

Arguments

table

Nombre de una tabla que tiene habilitado el texto completo y la indexación semántica.

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

column

Nombre de la columna indizada para la que deben devolverse resultados. La columna debe tener habilitada la indización semántica.

column_list

Indica varias columnas, separadas por comas y escritas entre paréntesis. Todas las columnas deben tener habilitada la indización semántica.

*

Indica que se incluyen todas las columnas que tienen la indización semántica habilitada.

source_key

Clave única de la fila, para solicitar los resultados de una fila concreta.

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

Tabla devuelta

En la tabla siguiente se describe la información acerca de documentos similares o relacionados que esta función de conjunto de filas devuelve.

Los documentos coincidentes se devuelven por columna si se solicitan resultados de más de una columna.

Nombre de la columna Type Description
source_column_id 1 int Identificador de la columna de la que se usó un documento de origen para buscar documentos similares.
matched_column_id 1 int Identificador de la columna de la que se encontró un documento similar.
matched_document_key *

Esta clave coincide con el tipo de la clave única de la tabla de origen.		 Valor de clave única de extracción semántica y de texto completo del documento o la fila que resultaron ser similares al documento especificado en la consulta.
score real Valor relativo de similitud para este documento en su relación con todos los demás documentos similares. El valor es un valor decimal fraccionario en el intervalo de [0,0, 1,0] donde una puntuación más alta representa una coincidencia más cercana y 1,0 es una puntuación perfecta.

1 Vea las funciones COL_NAME y COLUMNPROPERTY para obtener más información sobre cómo recuperar el nombre de columna de column_id y viceversa.

Remarks

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

Limitations

No se pueden consultar entre columnas para documentos similares. La SEMANTICSIMILARITYTABLE función solo recupera documentos similares de la misma columna que la columna de origen, que se identifica mediante el argumento source_key .

Metadata

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:

Permissions

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

Examples

En el ejemplo siguiente se recuperan los 10 candidatos principales que son similares a un candidato especificado de la tabla de la HumanResources.JobCandidateAdventureWorks2025 base de datos de ejemplo.

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;
  • Last updated on