sys.dm_fts_index_keywords (Transact-SQL)

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â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(4000)

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(4000)

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 palavras irrelevantes.

ObservaçãoObservaçã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 por 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 ele se prolonga por mais de uma linha no fragmento de índice, ou quando ele 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

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

Exemplos

A. Exibe 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 AdventureWorks2008R2. .

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