sp_fulltext_service (Transact-SQL)

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.

  Hinweis
  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 Durchforstungen 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. Hinweis 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. Hinweis 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. Die Sprachen werden beim Konfigurieren der Indizierung und in Volltextabfragen angegeben. Zum Extrahieren von Textinformationen aus entsprechenden Dateiformaten wie .docx, die in Datentypen wie varbinary, varbinary(max), image oder, für Volltextindizierung, in xml gespeichert sind, werden vom Filterdaemonhost Filter 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

EXEC sp_fulltext_service 'update_languages';
GO

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

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

Siehe auch

Verweis

Konzepte