semanticsimilaritytable (Transact-SQL)

Artigo
08/11/2023

Aplica-se a:SQL Server

Retorna uma tabela de zero, uma ou mais linhas para documentos cujo conteúdo nas colunas especificadas é semanticamente semelhante a um documento especificado.

Essa função de conjunto de linhas pode ser referenciada na cláusula FROM de uma instrução SELECT como um nome de tabela regular.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

table
É o nome de uma tabela que tem a indexação semântica e de texto completo habilitada.

Esse nome pode ser um nome de uma a quatro partes, mas um nome de servidor remoto não é permitido.

column
Nome da coluna indexada para a qual os resultados devem ser retornados. A coluna deve ter a indexação semântica habilitada.

column_list
Indica várias colunas, separadas por vírgula e entre parênteses. Todas as colunas devem ter a indexação semântica habilitada.

*
Indica que todas as colunas com indexação semântica habilitada estão incluídas.

source_key
Chave exclusiva para a linha, para solicitar resultados para uma linha específica.

A chave é convertida implicitamente para o tipo da chave exclusiva de texto completo na tabela de origem sempre que possível. A chave pode ser especificada como uma constante ou uma variável, mas não pode ser uma expressão ou o resultado de uma subconsulta escalar.

Tabela retornada

A tabela a seguir descreve as informações sobre documentos semelhantes ou relacionados que essa função de conjunto de linhas retorna.

Os documentos correspondentes são retornados por coluna se os resultados forem solicitados de mais de uma coluna.

Column_name	Tipo	Descrição
source_column_id	int	ID da coluna a partir da qual um documento de origem foi usado para localizar documentos semelhantes. Consulte as funções COL_NAME e COLUMNPROPERTY para obter detalhes sobre como recuperar o nome da coluna de column_id e vice-versa.
matched_column_id	int	ID da coluna a partir da qual um documento semelhante foi encontrado. Consulte as funções COL_NAME e COLUMNPROPERTY para obter detalhes sobre como recuperar o nome da coluna de column_id e vice-versa.
matched_document_key	* Essa chave corresponde ao tipo da chave exclusiva na tabela de origem.	Valor de chave exclusivo de texto completo e extração semântica do documento ou linha que foi encontrado para ser semelhante ao documento especificado na consulta.
score	REAL	Um valor relativo para semelhança para este documento em sua relação com todos os outros documentos semelhantes. O valor é um valor decimal fracionário no intervalo de [0,0, 1,0] onde uma pontuação mais alta representa uma correspondência mais próxima e 1,0 é uma pontuação perfeita.

Comentários gerais

Para obter mais informações, consulte Localizar documentos semelhantes e relacionados com a pesquisa semântica.

Limitações e Restrições

Não é possível consultar documentos semelhantes entre colunas. A função SEMANTICSIMILARITYTABLE só recupera documentos semelhantes da mesma coluna que a coluna de origem, que é identificada pelo argumento source_key .

Metadados

Para obter informações e status sobre extração de similaridade semântica e população, consulte as seguintes exibições de gerenciamento dinâmico:

Segurança

Permissões

Requer permissões SELECT na tabela base na qual os índices de texto completo e semântico foram criados.

Exemplos

O exemplo a seguir recupera os 10 principais candidatos que são semelhantes a um candidato especificado da tabela HumanResources.JobCandidate no AdventureWorks2022 banco de dados de exemplo.

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;