Freigeben über


sp_fulltext_service (Transact-SQL)

Gilt für: SQL Server

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

Achtung

Die upgrade_option Aktion wird in SQL Server 2022 (16.x) und höheren Versionen nicht vollständig unterstützt. Weitere Informationen finden Sie im Abschnitt zur Kompatibilität mit SQL Server 2022 und höheren Versionen weiter unten in diesem Artikel.

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @action = ] N'action'

Die eigenschaft, die geändert oder zurückgesetzt werden soll. @action ist nvarchar(100), ohne Standard. Eine Liste der @action Eigenschaften, deren Beschreibungen und die Werte, die festgelegt werden können, finden Sie in der Tabelle unter dem Argument @value .

Dieses Argument gibt die folgenden Eigenschaften zurück:

  • Datentyp
  • Aktueller Laufender Wert
  • Minimal- oder Maximalwert
  • Status "Veraltet", falls zutreffend.

[ @value = ] value

@value ist sql_variant, mit einem Standardwert von NULL.

Der Wert der angegebenen Eigenschaft @value ist sql_variant mit einem Standardwert von NULL. Wenn @value null ist, sp_fulltext_service wird die aktuelle Einstellung zurückgegeben. In dieser Tabelle werden Aktionseigenschaften, zugehörige Beschreibungen und die festzulegenden Werte aufgelistet.

Hinweis

Die folgenden Aktionen werden in einer zukünftigen Version von SQL Server entfernt: clean_up, , connect_timeout, data_timeoutund 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 Wird nur aus Gründen der Abwärtskompatibilität unterstützt. Der Wert ist immer 0.
connect_timeout int Wird nur aus Gründen der Abwärtskompatibilität unterstützt. Der Wert ist immer 0.
data_timeout int Wird nur aus Gründen der Abwärtskompatibilität unterstützt. Der Wert ist immer 0.
load_os_resources int Gibt an, ob Worttrennungen, Wortstammerkennungen und Filter des Betriebssystems bei dieser Instanz von SQL Server registriert und verwendet werden. Eine der folgenden Optionen:

0 = Verwenden Sie nur Filter und Worttrennungen, die für diese Instanz von SQL Server spezifisch sind.

1 = Betriebssystemfilter und Worttrennungen laden.

Standardmäßig ist diese Eigenschaft deaktiviert, damit das Verhalten durch Updates des Systems nicht versehentlich geändert wird. Die Aktivierung der Verwendung von Betriebssystemressourcen bietet Zugriff auf Ressourcen für Sprachen und Dokumenttypen, die bei Microsoft Indexing Service registriert sind und keine instanzspezifische Ressource installiert haben. Wenn Sie das Laden von Betriebssystemressourcen aktivieren, stellen Sie sicher, dass die Betriebssystemressourcen vertrauenswürdig signierte Binärdateien sind. andernfalls können sie nicht geladen werden, wenn verify_signature sie auf 1.
master_merge_dop int Gibt die Anzahl der Threads an, die vom Masterzusammenführungsprozess verwendet werden soll. Dieser Wert sollte die Anzahl der verfügbaren CPUs oder CPU-Kerne nicht überschreiten.

Wenn dieses Argument nicht angegeben ist, verwendet der Dienst den geringeren wert 4oder die Anzahl der verfügbaren CPUs oder CPU-Kerne.
pause_indexing int Gibt an, ob die Volltextindizierung angehalten werden soll, wenn sie gerade ausgeführt oder fortgesetzt wird, wenn sie derzeit angehalten ist.

0 = Setzt Volltextindizierungsaktivitäten für die Serverinstanz fort.

1 = Hält Volltextindizierungsaktivitäten für die Serverinstanz an.
resource_usage int Hat keine Funktion in SQL Server 2008 (10.0.x) und höheren Versionen und wird ignoriert.
update_languages NULL Aktualisiert die Liste der für die Volltextsuche registrierten Sprachen. Die Sprachen werden beim Konfigurieren der Indizierung und in Volltextabfragen angegeben. Filter werden vom Filterdaemonhost verwendet, um Textinformationen aus den entsprechenden Dateiformaten zu extrahieren, z .docx . B. in Datentypen gespeichert, z . B. varbinary, varbinary(max), image, or xml, for full-text indexing.

Weitere Informationen finden Sie unter Anzeigen oder Ändern registrierter Filter und Worttrennungen.
upgrade_option int Steuert, wie Volltextindizes beim Upgrade einer Datenbank von SQL Server 2005 (9.x) auf eine höhere Version migriert werden. 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.

Eine der folgenden Optionen:

- 0 = Volltextkataloge werden mit den neuen und erweiterten Worttrennungen neu erstellt. Das Neuerstellen von Indizes kann einige Zeit in Anspruch nehmen, und nach dem Upgrade kann eine erhebliche Menge an CPU und Arbeitsspeicher erforderlich sein.

- 1 = Volltextkataloge werden zurückgesetzt. SQL Server 2005 (9.x) Volltextkatalogdateien werden entfernt. Die Metadaten für die Volltextkataloge und die Volltextindizes bleiben jedoch erhalten. Nach dem Upgrade werden alle Volltextindizes für die Änderungsnachverfolgung deaktiviert und Durchforstungen werden nicht automatisch gestartet. Der Katalog bleibt leer, bis Sie ihn nach Beendigung des Upgrades manuell vollständig auffüllen.

- 2 = Volltextkataloge werden importiert. In der Regel ist der Import schneller als neu erstellt. 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 und erweiterten Worttrennungen, daher sollten Sie stattdessen Ihre Volltextkataloge neu erstellen. In SQL Server 2022 (16.x) und höheren Versionen entfernt und löst einen Fehler aus.

Hinweis: Die Neuerstellung kann im Multithreadmodus ausgeführt werden, und wenn mehr als 10 CPUs verfügbar sind, kann die Neuerstellung schneller ausgeführt werden als beim Import, wenn Sie die Neuerstellung für die Verwendung aller CPUs zulassen.

Wenn kein Volltextkatalog verfügbar ist, werden die zugehörigen Volltextindizes neu erstellt. Diese Option ist nur für SQL Server 2005-Datenbanken (9.x) verfügbar.

Informationen zum Auswählen einer Option für das Volltextupgrade finden Sie unterUpgrade der Volltextsuche.

Hinweis: Verwenden Sie die Option "Full-Text Upgrade Option ", um diese Eigenschaft in SQL Server Management Studio festzulegen. Weitere Informationen finden Sie unter Verwalten und Überwachen der Volltextsuche auf einer Serverinstanz.
verify_signature int Gibt an, ob das Volltextmodul nur signierte Binärdateien lädt. Standardmäßig werden nur vertrauenswürdige signierte Binärdateien geladen.

1 = Stellen Sie sicher, dass nur vertrauenswürdige, signierte Binärdateien geladen werden (Standard).

0 = Überprüfen Sie nicht, ob Binärdateien signiert sind.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Keine.

Kompatibilität mit SQL Server 2022 und höheren Versionen

Das Importfeature in der upgrade_option Aktion (angegeben durch @action = 'upgrade_option', @value = 2) wird in SQL Server 2022 (16.x) und höheren Versionen entfernt. Wenn Sie einen Volltextindex aus einer älteren Version von SQL Server importieren müssen, können Sie ihn mit SQL Server 2019 (15.x) oder früheren Versionen importieren und dann auf SQL Server 2022 (16.x) aktualisieren.

Berechtigungen

Nur Mitglieder der Serveradmin-Serverrolle mit fester Serverrolle oder der Systemadministrator können ausgeführt werden sp_fulltext_service.

Beispiele

A. Aktualisieren der Liste der registrierten Sprachen

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

EXECUTE sp_fulltext_service 'update_languages';
GO

B. Ändern der Volltextupgradeoption zum Zurücksetzen von Volltextkatalogen

Im folgenden Beispiel wird die Volltextupgradeoption so geändert, dass Volltextkataloge zurückgesetzt und vollständig entfernt werden. In diesem Beispiel werden die optionalen @action und @value Argumente angegeben.

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