Condividi tramite


sys.dm_fts_index_keywords (Transact-SQL)

Vengono restituite le informazioni sul contenuto di un indice full-text per la tabella specificata.

sys.dm_fts_index_keywords è una funzione a gestione dinamica.

Nota

Per visualizzare informazioni sull'indice full-text di livello inferiore, utilizzare la funzione a gestione dinamica sys.dm_fts_index_keywords_by_document a livello del documento.

Sintassi

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

Argomenti

  • db_id('database_name')
    Chiamata alla funzione DB_ID(). Tramite tale funzione viene accettato un nome di database e viene restituito l'ID del database, utilizzato da sys.dm_fts_index_keywords per individuare il database specificato. Se database_name viene omesso, viene restituito l'ID del database corrente.

  • object_id('table_name')
    Chiamata alla funzione OBJECT_ID(). Tramite tale funzione viene accettato un nome di tabella e viene restituito l'ID della tabella che contiene l'indice full-text da controllare.

Tabella restituita

Nome colonna

Tipo di dati

Descrizione

keyword

nvarchar(4000)

Rappresentazione esadecimale della parola chiave archiviata nell'indice full-text.

NotaNota
OxFF rappresenta il carattere speciale che indica la fine di un file o di un set di dati.

display_term

nvarchar(4000)

Formato leggibile della parola chiave derivato dal formato esadecimale.

NotaNota
Il valore display_term per OxFF è "END OF FILE".

column_id

int

ID della colonna utilizzata per eseguire l'indicizzazione full-text della parola chiave corrente.

document_count

int

Numero di documenti o righe che contengono il termine corrente.

Osservazioni

Le informazioni restituite da sys.dm_fts_index_keywords sono utili per individuare, tra gli altri, gli elementi seguenti:

  • Appartenenza di una parola chiave all'indice full-text.

  • Numero di documenti o righe che contengono una parola chiave specificata.

  • Parola chiave più comune nell'indice full-text:

    • document_count di ogni keyword_value confrontato con il valore di document_count totale, ovvero il numero di documenti di 0xFF.

    • In genere è più appropriato definire come parole non significative le parole chiave più comuni.

Nota

È possibile che document_count restituito da sys.dm_fts_index_keywords sia meno preciso per un documento specifico rispetto al conteggio restituito da sys.dm_fts_index_keywords_by_document o da una query CONTAINS. Questa possibile imprecisione è stimata essere minore dell'1%. Può verificarsi in quanto document_id potrebbe essere contato due volte se si ripete in più di una riga nel frammento di indice o se viene visualizzato più di una volta nella stessa riga. Per ottenere un conteggio più preciso per un documento specifico, utilizzare sys.dm_fts_index_keywords_by_document o una query CONTAINS.

Autorizzazioni

Sono necessarie le autorizzazioni CREATE FULLTEXT CATALOG e SELECT per le colonne analizzate dall'indice full-text.

Esempi

A. Visualizzazione del contenuto dell'indice full-text dettagliato

Nell'esempio seguente vengono visualizzate informazioni sul contenuto di alto livello dell'indice full-text nella tabella HumanResources.JobCandidate del database di esempio AdventureWorks2008R2. .

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