semanticsimilaritydetailstable (Transact-SQL)

Artigo
07/05/2024

Aplica-se a: SQL Server

Retorna uma tabela de zero, uma ou mais linhas de frases-chave comuns entre dois documentos (um documento de origem e um documento correspondido) cujo conteúdo é semanticamente similar.

Essa função de conjunto de linhas pode ser referenciada na cláusula FROM de uma instrução SELECT

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

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

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

source_column
Nome da coluna na linha de origem que contém o conteúdo a ser comparado para semelhança.

source_key
A chave exclusiva que representa a linha do documento original.

Essa chave é convertida implicitamente no tipo de chave exclusiva de texto completo na tabela de origem sempre que possível. A chave pode ser especificaca como uma constante ou variável, mas não pode ser uma expressão ou o resultado de uma subconsulta escalar. Se uma chave inválida for especificada, nenhuma linha será retornada.

matched_column
Nome da coluna na linha correspondente que contém o conteúdo a ser comparado para semelhança.

matched_key
A chave exclusiva que representa a linha do documento correspondente.

Tabela retornada

A tabela a seguir descreve as informações sobre as frases-chave que podem ser retornadas por essa função de conjunto de linhas.

Column_name	Tipo	Descrição
frase-chave	NVARCHAR	A frase chave que contribui com a semelhança entre o documento original e o documento correspondente.
score	REAL	Um valor relativo para essa frase-chave em sua relação com todas as outras frases-chave que são semelhantes entre os 2 documentos. O valor é um valor decimal fracionário no intervalo de [0,0, 1,0] onde uma pontuação mais alta representa peso mais alto e 1,0 é a pontuação perfeita.

Comentários gerais

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

Metadados

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

Segurança

Permissões

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

Exemplos

O exemplo a seguir recupera as 5 frases-chave que tiveram a pontuação de similaridade mais alta entre os candidatos especificados na tabela HumanResources.JobCandidate do AdventureWorks2022 banco de dados de exemplo. As @CandidateId variáveis e @MatchedID representam valores da coluna de chave do í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;

Compartilhar via