sys.dm_fts_index_keywords (Transact-SQL)

Artigo
06/18/2013

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çã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 à 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 à 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

keyword

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 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çã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 comparada com a 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 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 de um documento específico, use sys.dm_fts_index_keywords_by_document ou uma consulta CONTAINS.

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 de 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

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

Consulte também

Referência

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

sys.dm_fts_index_keywords_by_document (Transact-SQL)

Conceitos

Pesquisa de texto completo (SQL Server)

Partilhar via