semanticsimilaritytable (Transact-SQL)
Aplica-se: 
SQL Server
Retorna uma tabela de zero, uma ou mais linhas para documentos cujo conteúdo nas colunas especificadas é semanticamente similar 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 normal.
Convenções de sintaxe de Transact-SQL
Sintaxe
SEMANTICSIMILARITYTABLE
(
table,
{ column | (column_list) | * },
source_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.
column
Nome da coluna indexada para a qual os resultados devem ser retornados. A coluna deve ter indexação semântica habilitada.
column_list
Indica várias colunas, separadas por uma vírgula e incluídas entre parênteses. Todas as colunas devem ter indexação semântica habilitada.
*
Indica que todas as colunas que têm indexação semântica habilitada estão incluídas.
source_key
Chave exclusiva da linha para solicitar resultados de 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 especificaca como uma constante ou 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 retornados por esta função de conjunto de linhas.
Documentos correspondidos serã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 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 do column_id e vice-versa. |
| matched_column_id | int | ID da coluna da qual um documento similar foi localizado. Consulte as funções COL_NAME e COLUMNPROPERTY para obter detalhes sobre como recuperar o nome da coluna do column_id e vice-versa. |
| matched_document_key | * Essa chave corresponde ao tipo da chave exclusiva na tabela de origem. |
Valor da chave exclusiva da extração de texto completo e semântica do documento ou linha que foi localizada como similar ao documento especificado na consulta. |
| score | REAL | Um valor relativo da similaridade deste documento em sua relação com todos os outros documentos similares. 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 similares em colunas. A função SEMANTICSIMILARITYTABLE recupera apenas documentos semelhantes da mesma coluna que a coluna de origem, que é identificada pelo argumento source_key .
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 os 10 principais candidatos 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;