semanticsimilaritytable (Transact-SQL)

Artículo
08/11/2023

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 cláusula FROM de una instrucción SELECT como un nombre de tabla normal.

Convenciones de sintaxis de Transact-SQL

Sintaxis

SEMANTICSIMILARITYTABLE  
    (  
    table,  
    { column | (column_list) | * },  
    source_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.

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

lista_de_columnas
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 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 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.

Column_name	Tipo	Descripción
source_column_id	int	Identificador de la columna de la que se usó un documento de origen para buscar documentos similares. Vea las funciones COL_NAME y COLUMNPROPERTY para obtener información detallada sobre cómo recuperar el nombre de columna desde column_id y viceversa.
matched_column_id	int	Identificador de la columna de la que se encontró un documento similar. Vea las funciones COL_NAME y COLUMNPROPERTY para obtener información detallada sobre cómo recuperar el nombre de columna desde column_id y viceversa.
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 fraccionario decimal en el intervalo de [0.0, 1.0] donde una puntuación superior representa una coincidencia más próxima y 1.0 es una puntuación perfecta.

Notas generales

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

Limitaciones y restricciones

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

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:

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 los 10 candidatos principales que son similares a un candidato especificado de la tabla HumanResources.JobCandidate de la AdventureWorks2022 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;

Compartir vía