Freigeben über

  • Artikel

sp_fulltext_service (Transact-SQL)

Ändert die Servereigenschaften der Volltextsuche für SQL Server.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_fulltext_service [ [@action=] 'action' 
     [ , [ @value= ] value ] ]

Argumente

  • [ @action=] 'action'
    Bezeichnet die zu ändernde oder zurückzusetzende Eigenschaft. action ist ein Wert vom Datentyp nvarchar(100), und weist keinen Standardwert auf. Eine Liste der action-Eigenschaften, zugehörigen Beschreibungen und festzulegenden Werte finden Sie in der Tabelle unterhalb des value-Arguments. Dieses Argument gibt die folgenden Eigenschaften zurück: Datentyp, aktuell zur Ausführung verwendeter Wert, Minimal- oder Maximalwert und ggf. Status zur Aktualität.

  • [@value=] value
    Bezeichnet den Wert der angegebenen Eigenschaft. value ist ein Wert vom Datentyp sql_variant; der Standardwert ist NULL. Wenn @value gleich NULL ist, gibt sp_fulltext_service die aktuelle Einstellung zurück. In dieser Tabelle werden Aktionseigenschaften, zugehörige Beschreibungen und die festzulegenden Werte aufgelistet.

    HinweisHinweis

    Die folgenden Aktionen werden in einer künftigen Version von SQL Server nicht mehr unterstützt: clean_up, connect_timeout, data_timeout und resource_usage. Vermeiden Sie die Verwendung dieser Aktionen bei neuen Entwicklungsarbeiten, und planen Sie die Änderung von Anwendungen, die diese Aktionen zurzeit verwenden.

    Aktion

    Datentyp

    Beschreibung

    clean_up

    int

    Nur aus Gründen der Abwärtskompatibilität unterstützt. Der Wert lautet stets 0 (null).

    connect_timeout

    int

    Nur aus Gründen der Abwärtskompatibilität unterstützt. Der Wert lautet stets 0 (null).

    data_timeout

    int

    Nur aus Gründen der Abwärtskompatibilität unterstützt. Der Wert lautet stets 0 (null).

    upgrade_option

    int

    Steuert, wie Volltextindizes migriert werden, wenn Sie eine Datenbank von SQL Server 2000 oder SQL Server 2005 nach SQL Server 2008 oder höher migrieren. Diese Eigenschaft ist für die folgenden Aktionen gültig: Upgrade durch Anfügen einer Datenbank, Wiederherstellen einer Datenbanksicherung, Wiederherstellen einer Dateisicherung oder Kopieren der Datenbank mit dem Assistenten zum Kopieren von Datenbanken.

    Folgende Angaben sind möglich:

    0 = Volltextkataloge werden mithilfe der neuen und verbesserten Worttrennmodule neu erstellt. Das Neuerstellen von Indizes kann einige Zeit dauern, und nach der Aktualisierung ist ggf. eine beträchtliche Menge an CPU-Leistung und Arbeitsspeicherkapazität erforderlich.

    1 = Volltextkataloge werden zurückgesetzt. Volltextkatalogdateien der Version SQL Server 2005 werden entfernt. Die Metadaten für die Volltextkataloge sowie die Volltextindizes bleiben erhalten. Nach der Aktualisierung wird die Änderungsnachverfolgung für alle Volltextindizes deaktiviert, und Crawls werden nicht automatisch gestartet. Der Katalog bleibt leer, bis Sie ihn nach Beendigung der Aktualisierung manuell vollständig auffüllen.

    2 = Volltextkataloge werden importiert. Normalerweise ist der Import bedeutend schneller als eine Neuerstellung. Wenn Sie zum Beispiel nur eine CPU verwenden, läuft ein Import etwa zehnmal schneller ab als eine Neuerstellung. Ein importierter Volltextkatalog verwendet jedoch nicht die neuen mit SQL Server 2008 eingeführten Wörtertrennungen. Aus diesem Grund sollten Sie zu einem späteren Zeitpunkt eine Neuerstellung der Volltextkataloge durchführen.

    HinweisHinweis
    Sie können die Neuerstellung im Multithreadmodus ausführen. Wenn mehr als 10 CPUs verfügbar sind, ist die Neuerstellung ggf. schneller als der Import, falls dabei alle CPUs genutzt werden können.

    Wenn ein Volltextkatalog nicht verfügbar ist, werden die zugehörigen Volltextindizes neu erstellt. Diese Option ist nur für SQL Server 2005-Datenbanken verfügbar.

    Informationen zum Auswählen einer Volltext-Aktualisierungsoption finden Sie unter Aktualisieren der Volltextsuche.

    HinweisHinweis
    Um diese Eigenschaft in SQL Server Management Studio festzulegen, verwenden Sie die Eigenschaft Volltext-Aktualisierungsoption. Weitere Informationen finden Sie unter Vorgehensweise: Anzeigen oder Ändern von Servereigenschaften für die Volltextsuche (SQL Server Management Studio).

    load_os_resources

    int

    Gibt an, ob Wörtertrennungen, Wortstammerkennungen und Filter des Betriebssystems mit dieser Instanz von SQL Server registriert sind und verwendet werden. Folgende Angaben sind möglich:

    0 = Nur spezifische Filter und Wörtertrennungen für diese Instanz von SQL Server verwenden.

    1 = Betriebssystemfilter und Wörtertrennungen laden.

    Standardmäßig ist diese Eigenschaft deaktiviert, damit das Verhalten durch Updates des Systems nicht versehentlich geändert wird. Wenn die Verwendung von Betriebssystemressourcen aktiviert wird, kann auf Ressourcen für Sprachen und Dokumenttypen zugegriffen werden, die beim Microsoft-Indexdienst registriert sind, für die jedoch keine instanzspezifische Ressource installiert wurde. Wenn Sie das Laden von Betriebssystemressourcen aktivieren, sollten Sie sicherstellen, dass die Betriebssystemressourcen vertrauenswürdige signierte Binärdateien sind, da sie sonst nicht geladen werden können, wenn verify_signature (siehe unten) auf 1 festgelegt wird.

    pause_indexing

    int

    Gibt an, ob die Volltextindizierung angehalten werden soll, wenn sie ausgeführt wird, oder fortgesetzt werden soll, wenn sie angehalten wurde.

    0 = Setzt die Aktivitäten zur Volltextindizierung für die Serverinstanz fort.

    1 = Hält die Aktivitäten zur Volltextindizierung für die Serverinstanz an.

    resource_usage

    int

    Hat in SQL Server 2008 und höheren Versionen keine Funktion und wird ignoriert.

    update_languages

    NULL

    Aktualisiert die Liste der für die Volltextsuche registrierten Sprachen und Filter. Die Sprachen werden beim Konfigurieren der Indizierung und in Volltextabfragen angegeben. Filter werden vom Filterdaemonhost zum Extrahieren von Textinformationen aus entsprechenden Dateiformaten wie DOCX, die in Datentypen wie varbinary, varbinary(max), image oder xml gespeichert sind, für die Volltextindizierung verwendet.

    Weitere Informationen finden Sie unter Vorgehensweise: Ändern der Liste mit registrierten Wörtertrennungen und Filtern (Transact-SQL).

    verify_signature

    int

    Gibt an, ob ausschließlich signierte Binärdateien vom Volltextmodul geladen werden. Standardmäßig werden nur vertrauenswürdige signierte Binärdateien geladen.

    1 = Überprüfen, ob ausschließlich vertrauenswürdige signierte Binärdateien geladen werden (Standardeinstellung).

    0 = Nicht überprüfen, ob Binärdateien signiert sind.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Berechtigungen

Nur Mitglieder der festen Serverrolle serveradmin und der Systemadministrator können sp_fulltext_service ausführen.

Beispiele

A. Aktualisieren der Liste registrierter Sprachen

Im folgenden Beispiel wird die Liste der für die Volltextsuche registrierten Sprachen aktualisiert.

EXEC sp_fulltext_service 'update_languages';
GO

B. Ändern der Volltext-Aktualisierungsoption, um Volltextkataloge zurückzusetzen

Im folgenden Beispiel wird die Volltext-Aktualisierungsoption geändert, sodass Volltextkataloge zurückgesetzt werden. Damit werden die Kataloge vollständig entfernt. In diesem Beispiel werden die optionalen Schlüsselwörter @action und @value angegeben.

EXEC sp_fulltext_service @action='upgrade_option', @value=1;
GO

Änderungsverlauf

Aktualisierter Inhalt

Die Beschreibung von update_languages wurde überarbeitet.