sys.dm_fts_index_keywords (Transact-SQL)

Aplica-se a: SQL ServerBase de Dados SQL do AzureAzure SQL Managed Instancebase de dados SQL em Microsoft Fabric

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 gestão dinâmica.

Observação

Para visualizar informações índices de texto completo de nível inferior, utilize a função de gestão dinâmica sys.dm_fts_index_keywords_by_document ao 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 . DB_ID é inteligência. Esta função aceita um nome de base de dados e devolve o ID da base de dados, que sys.dm_fts_index_keywords serve para encontrar a base de dados especificada. Se database_name for omitido, o ID atual da base de dados é devolvido.

OBJECT_ID('table_name')

Uma chamada para a função OBJECT_ID . OBJECT_ID é inteligência. Esta função aceita um nome de tabela e devolve o ID da tabela que contém o índice de texto completo para inspecionar.

Tabela retornada

Nome da coluna Tipo de dados Anulável Description
keyword 1 varbinary(128) No A representação hexadecimal da palavra-chave armazenada no índice do texto completo.
display_term 2 nvarchar(4000) No O formato legível para humanos da palavra-chave. Este formato deriva do formato hexadecimal.
column_id int No ID da coluna a partir da qual a palavra-chave atual foi indexada em texto completo.
document_count bigint Sim Número de documentos ou linhas que contêm o termo atual.

10xFF representa o carácter especial que indica o fim de um ficheiro ou conjunto de dados.
2 O display_term valor para 0xFF é END OF FILE.

Observações

A informação detida 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 dada palavra-chave?

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

    • document_count de cada keyword_value comparado com o total document_count, o número de documentos de 0xFF.

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

O document_count valor devolvido por sys.dm_fts_index_keywords pode ser menos preciso para um documento específico do que a contagem devolvida por sys.dm_fts_index_keywords_by_document ou uma CONTAINS consulta. Esta imprecisão potencial é estimada em menos de 1%. Esta imprecisão pode ocorrer porque a document_id pode ser contada duas vezes quando continua em mais do que uma linha no fragmento do índice, ou quando aparece mais do que 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 faça uma CONTAINS consulta.

Permissions

Requer associação na função fixa de servidor sysadmin.

Examples

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

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

SELECT *
FROM sys.dm_fts_index_keywords(DB_ID('AdventureWorks2025'), OBJECT_ID('HumanResources.JobCandidate'));
GO