semantickeyphrasetable (Transact-SQL)

Artigo
05/23/2023

Aplica-se: SQL Server

Retorna uma tabela com zero, uma ou mais linhas para essas frases-chave associadas às colunas especificadas da tabela especificada.

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

Convenções de sintaxe de Transact-SQL

Sintaxe

SEMANTICKEYPHRASETABLE  
    (  
    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. Se a source-key for omitida, os resultados serão retornados para todas as linhas.

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
column_id	int	ID da coluna da qual a frase-chave atual foi extraída e indexada. Consulte as funções COL_NAME e COLUMNPROPERTY para obter detalhes sobre como recuperar o nome da coluna do column_id e vice-versa.
document_key	* Essa chave corresponde ao tipo da chave exclusiva na tabela de origem.	O valor da chave exclusiva do documento ou linha a partir da qual a frase-chave atual foi indexada.
frase-chave	NVARCHAR	A frase-chave localizada na coluna identificada por column_id e associada ao documento especificado por document_key.
score	REAL	Um valor relativo para essa frase-chave em sua relação com todas as outras frases-chave no mesmo documento na coluna indexada. 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 frases-chave em documentos com pesquisa semântica.

Metadados

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

Segurança

Permissões

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

Exemplos

Exemplo 1: Localizar as principais frases-chave em um documento específico

O exemplo a seguir recupera as 10 principais frases-chave do documento especificado pela variável @DocumentId na coluna Document da tabela Production.Document do banco de dados de exemplo AdventureWorks. A variável @DocumentId representa um valor da coluna de chave do índice de texto completo. A função SEMANTICKEYPHRASETABLE recupera esses resultados com eficácia usando uma busca de índice em vez de um exame de tabela. Este exemplo assume que a coluna está configurada para indexação de texto completo e semântica.

SELECT TOP(10) KEYP_TBL.keyphrase  
FROM SEMANTICKEYPHRASETABLE  
    (  
    Production.Document,  
    Document,  
    @DocumentId  
    ) AS KEYP_TBL  
ORDER BY KEYP_TBL.score DESC;

Exemplo 2: Localizar os principais documentos que contêm uma frase-chave específica

O exemplo a seguir recupera os 25 principais documentos que contêm a frase-chave "Bracket" da coluna Document da tabela Production.Document do banco de dados de exemplo AdventureWorks. Este exemplo assume que a coluna está configurada para indexação de texto completo e semântica.

SELECT TOP (25) DOC_TBL.DocumentID, DOC_TBL.DocumentSummary  
FROM Production.Document AS DOC_TBL  
    INNER JOIN SEMANTICKEYPHRASETABLE  
    (  
    Production.Document,  
    Document  
    ) AS KEYP_TBL  
ON DOC_TBL.DocumentID = KEYP_TBL.document_key  
WHERE KEYP_TBL.keyphrase = 'Bracket'  
ORDER BY KEYP_TBL.Score DESC;

Compartilhar via