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. .gif "Nota") Nota
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. Nota
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