sys.dm_fts_index_keywords (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceSQL-Datenbank in Microsoft Fabric

Gibt Informationen zum Inhalt eines Volltextindex für die angegebene Tabelle zurück.

sys.dm_fts_index_keywords ist eine dynamische Verwaltungsfunktion.

Note

Um niedrigere Volltext-Indexinformationen einzusehen, verwenden Sie die sys.dm_fts_index_keywords_by_document dynamische Managementfunktion auf Dokumentebene.

Syntax

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

Argumente

DB_ID('database_name')

Ein Aufruf an die DB_ID Funktion. DB_ID ist int. Diese Funktion akzeptiert einen Datenbanknamen und gibt die Datenbank-ID zurück, die sys.dm_fts_index_keywords zur 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 an die OBJECT_ID Funktion. OBJECT_ID ist int. Diese Funktion akzeptiert einen Tabellennamen und gibt die Tabellen-ID der Tabelle zurück, die den Volltextindex zur Inspektion enthält.

Zurückgegebene Tabelle

Spaltenname Datentyp Nullfähig Description
keyword 1 varbinary(128) No Die hexadezimale Darstellung des Schlüsselworts, das im Volltextindex gespeichert ist.
display_term 2 nvarchar(4000) No Die Klartextform des Schlüsselworts. Dieses Format leitet sich vom hexadezimalen Format ab.
column_id int No Die ID der Spalte für die Volltextindizierung des aktuellen Schlüsselworts.
document_count bigint Ja Anzahl der Dokumente oder Zeilen, die den aktuellen Begriff enthalten.

10xFF steht für das Spezialzeichen, das das Ende einer Datei oder eines Datensatzes anzeigt.
2 Der Wert display_term für 0xFF ist END OF FILE.

Bemerkungen

Die von sys.dm_fts_index_keywords ihnen zurückgegebenen Informationen sind unter anderem nützlich, um Folgendes herauszufinden:

  • Ob ein Schlüsselwort Teil des Volltextindex ist.

  • Wie viele Dokumente oder Zeilen enthalten ein bestimmtes Schlüsselwort?

  • Das gebräuchlichste Schlüsselwort im Volltextindex:

    • document_count Von jedem keyword_value im Vergleich zum Gesamtbetrag document_countist die Dokumentenanzahl 0xFF.

    • Typischerweise sind gängige Schlüsselwörter geeignet, um sie als Stopwörter zu deklarieren.

Das zurückgegebene document_count Dokument sys.dm_fts_index_keywords kann für ein bestimmtes Dokument weniger genau sein als die Anzahl der von zurückgegebenen Dokument sys.dm_fts_index_keywords_by_document oder eine CONTAINS Abfrage. Diese potenzielle Ungenauigkeit wird auf weniger als 1%geschätzt. Diese Ungenauigkeit kann auftreten, weil a document_id zweimal gezählt werden kann, wenn es sich über mehr als eine Zeile im Indexfragment fortsetzt oder wenn es mehrmals in derselben Reihe erscheint. Um eine genauere Zählung für ein bestimmtes Dokument, eine Verwendung sys.dm_fts_index_keywords_by_document oder eine CONTAINS Abfrage zu erhalten.

Erlaubnisse

Erfordert die Mitgliedschaft in der festen Serverrolle "Sysadmin" (,).

Examples

A. Anzeige von hochrangigen Volltext-Indexinhalten

Das folgende Beispiel zeigt Informationen über den übergeordneten Inhalt des Volltextindex in der HumanResources.JobCandidate Tabelle.

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