Compartilhar via

sys.dm_fts_index_keywords (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server

Retorna informações sobre o conteúdo de um índice de texto completo da tabela especificada.

sys.dm_fts_index_keywords é uma função de gerenciamento dinâmico.

Observação

Para exibir informações de índice de texto completo de nível inferior, use a função de gerenciamento dinâmico sys.dm_fts_index_keywords_by_document no nível do documento.

Sintaxe

  
sys.dm_fts_index_keywords( DB_ID('database_name'), OBJECT_ID('table_name') )

Argumentos

db_id('database_name')
Uma chamada para a função DB_ID(). Essa função aceita um nome de banco de dados e retorna a ID do banco de dados, que sys.dm_fts_index_keywords usa para localizar o banco de dados especificado. Se database_name for omitido, a ID de banco de dados atual será retornada.

object_id('table_name')
Uma chamada para a função OBJECT_ID(). Essa função aceita um nome de tabela e retorna a ID da tabela que contém o índice de texto completo a ser inspecionado.

Tabela retornada

Nome da coluna Tipo de dados Descrição
Palavra-chave nvarchar(4000) A representação hexadecimal da palavra-chave armazenada dentro do índice de texto completo.

Observação: OxFF representa o caractere especial que indica o final de um arquivo ou conjunto de dados.
display_term nvarchar(4000) O formato legível da palavra-chave. Esse formato é derivado do formato hexadecimal.

Observação: o valor display_term para OxFF é "END OF FILE".
column_id int A ID da coluna a partir da qual a palavra-chave atual foi indexada com texto completo.
document_count int Número de documentos ou linhas que contém o termo atual.

Comentários

As informações retornadas pelo sys.dm_fts_index_keywords são úteis para descobrir o seguinte, entre outras coisas:

  • Se uma palavra-chave faz parte do índice de texto completo.

  • Quantos documentos ou linhas contêm uma determinada palavra-chave.

  • A palavra-chave mais comum no índice de texto completo:

    • document_count de cada keyword_value em comparação com o document_count total, a contagem de documentos de 0xFF.

    • Normalmente, palavras-chave comuns são apropriadas para declarar como palavras irrelevantes.

Observação

O document_count retornado por sys.dm_fts_index_keywords pode ser menos preciso para um documento específico do que a contagem retornada por sys.dm_fts_index_keywords_by_document ou uma consulta CONTAINS . Estima-se que a imprecisão em potencial seja inferior a 1%. Essa imprecisão pode ocorrer porque um document_id pode ser contado duas vezes quando continua em mais de uma linha no fragmento de índice ou quando aparece mais de uma vez na mesma linha. Para obter uma contagem mais precisa para um documento específico, use sys.dm_fts_index_keywords_by_document ou uma consulta CONTAINS.

Permissões

Exige associação à função de servidor fixa sysadmin .

Exemplos

R. Exibindo conteúdo de índice de texto completo de alto nível

O exemplo a seguir exibe informações sobre o conteúdo de alto nível do índice de texto completo na tabela HumanResources.JobCandidate.

SELECT * FROM sys.dm_fts_index_keywords(db_id('AdventureWorks2022'), object_id('HumanResources.JobCandidate'))  
GO

Confira também

Pesquisa de texto completo e pesquisa semântica Exibições e funções de gerenciamento dinâmico (Transact-SQL)
Pesquisa de texto completo
sys.dm_fts_index_keywords_by_document (Transact-SQL)