sys.dm_fts_index_keywords (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Restituisce 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 le informazioni sull'indice full-text di livello inferiore, usare la funzione di gestione dinamica sys.dm_fts_index_keywords_by_document a livello di 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(). Questa funzione accetta un nome di database e restituisce l'ID del database, che sys.dm_fts_index_keywords usa per trovare il database specificato. Se database_name viene omesso, viene restituito l'ID del database corrente.

object_id('table_name')
Chiamata alla funzione OBJECT_ID(). Tale funzione accetta un nome di tabella e restituisce 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.

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 le informazioni seguenti, tra le altre cose:

  • 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 rispetto al document_count totale, il conteggio dei documenti di 0xFF.

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

Nota

Il document_count restituito da sys.dm_fts_index_keywords può essere meno accurato 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%. Questa imprecisione può verificarsi perché un document_id può essere conteggiato due volte quando continua su più di una riga nel frammento di indice o quando appare più volte nella stessa riga. Per ottenere un conteggio più accurato per un documento specifico, usare sys.dm_fts_index_keywords_by_document o una query CONTAINS.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin .

Esempi

R. Visualizzazione del contenuto dell'indice full-text di alto livello

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

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

Vedi anche

Funzioni e viste a gestione dinamica ricerca full-text e funzioni (Transact-SQL)
Ricerca full-text
sys.dm_fts_index_keywords_by_document (Transact-SQL)