sys.dm_fts_index_keywords (Transact-SQL)

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

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

ObservaçãoObservaçã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 de 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 (). Esta função aceita um nome de banco de dados e retorna o identificado 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 do 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 o identificador da tabela que contém o índice de texto completo que será inspecionado.

Tabela retornada

Nome da coluna

Tipo de dados

Descrição

keyword

nvarchar(8000)

A representação hexadecimal da palavra-chave armazenada dentro do índice de texto completo.

ObservaçãoObservação
OxFF representa o caractere especial que indica o término de um arquivo ou conjunto de dados.

display_term

nvarchar(8000)

O formato legível da palavra-chave. Esse formato é derivado do formato hexadecimal.

ObservaçãoObservação
O valor display_term de 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

A informações retornada por sys.dm_fts_index_keywords é útil 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 comparados ao document_count total, a conta de documento de 0xFF.

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

Permissões

Requer permissões CREATE FULLTEXT CATALOG e a permissão SELECT nas colunas abrangidas pelo índice de texto completo.

Exemplos

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

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

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