sys.dm_fts_index_keywords (Transact-SQL)

Gibt Informationen über den Inhalt von einem Volltextindex für die angegebene Tabelle zurück.

sys.dm_fts_index_keywords ist eine dynamische Verwaltungsfunktion.

HinweisHinweis

Um Volltextindexinformationen auf niedrigerer Ebene anzuzeigen, verwenden Sie die dynamische Verwaltungsfunktion sys.dm_fts_index_keywords_by_document auf Dokumentebene.

Syntax

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

Argumente

  • db_id('database_name')
    Ein Aufruf der Funktion DB_ID(). Diese Funktion akzeptiert einen Datenbanknamen und gibt die Datenbank-ID zurück, die von sys.dm_fts_index_keywords für die Suche nach der angegebenen Datenbank verwendet wird. Wenn database_name nicht angegeben ist, wird die aktuelle Datenbank-ID zurückgegeben.

  • object_id('table_name')
    Ein Aufruf der Funktion OBJECT_ID(). Diese Funktion akzeptiert einen Tabellennamen und gibt die Tabellen-ID der Tabelle zurück, die den zu überprüfenden Volltextindex enthält.

Zurückgegebene Tabelle

Spaltenname

Datentyp

Beschreibung

keyword

nvarchar(4000)

Die hexadezimale Darstellung des Schlüsselworts, das im Volltextindex gespeichert ist.

HinweisHinweis
OxFF stellt das Sonderzeichen dar, mit dem das Ende einer Datei oder eines Datasets angegeben wird.

display_term

nvarchar(4000)

Die Klartextform des Schlüsselworts. Dieses Format wird vom Hexadezimalformat abgeleitet.

HinweisHinweis
Der display_term-Wert für OxFF ist "END OF FILE".

column_id

int

Die ID der Spalte für die Volltextindizierung des aktuellen Schlüsselworts.

document_count

int

Die Anzahl der Dokumente bzw. Zeilen, die den aktuellen Begriff enthalten.

Hinweise

Die von sys.dm_fts_index_keywords zurückgegebenen Informationen dienen u. a. zum Abrufen der folgenden Ergebnisse:

  • Ob ein Schlüsselwort ein Teil des Volltextindexes ist

  • Wie viele Dokumente bzw. Zeilen ein gegebenes Schlüsselwort enthalten

  • Das häufigste Schlüsselwort im Volltextindex:

    • Der document_count-Wert von jedem keyword_value wird mit dem gesamten document_count-Wert, der Dokumentanzahl von 0xFF, verglichen.

    • Häufige oder gemeinsame Schlüsselwörter eignen sich in der Regel für die Deklaration als Stoppwörter.

HinweisHinweis

Der document_count-Wert, der von sys.dm_fts_index_keywords zurückgegeben wird, kann für einzelne Dokumente ungenauer sein als der Wert, der von sys.dm_fts_index_keywords_by_document oder einer CONTAINS-Abfrage zurückgegeben wird. Die mögliche Ungenauigkeit liegt bei ca. 1 %. Ursache für eine solche Ungenauigkeit ist, dass eine document_id möglicherweise doppelt gezählt wird, wenn dieser über mehrere Zeilen im Indexfragment fortgeführt wird bzw. mehrere Male in derselben Zeile vorkommt. Um einen genaueren Wert für ein bestimmtes Dokument zu erhalten, verwenden Sie sys.dm_fts_index_keywords_by_document oder eine CONTAINS-Abfrage.

Berechtigungen

Erfordert CREATE FULLTEXT CATALOG-Berechtigungen und die SELECT-Berechtigung für die vom Volltextindex abgedeckten Spalten.

Beispiel

A. Anzeigen des Inhalts eines Volltextindex auf hoher Ebene

Im folgenden Beispiel werden Informationen über den Inhalt des Volltextindexes auf hoher Ebene in der HumanResources.JobCandidate-Tabelle der AdventureWorks2008R2-Beispieldatenbank angezeigt. .

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