CREATE FULLTEXT CATALOG (Transact-SQL)

  • Artikel

Erstellt einen Volltextkatalog für eine Datenbank. Ein Volltextkatalog kann mehrere Volltextindizes besitzen, ein Volltextindex kann jedoch nur Teil eines Volltextkatalogs sein. Jede Datenbank kann keinen oder mehrere Volltextkataloge enthalten.

In der master-, model- oder tempdb-Datenbank kann kein Volltextkatalog erstellt werden.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

CREATE FULLTEXT CATALOG catalog_name
     [ON FILEGROUP filegroup ]
     [IN PATH 'rootpath']
     [WITH <catalog_option>]
     [AS DEFAULT]
     [AUTHORIZATION owner_name ]

<catalog_option>::=
     ACCENT_SENSITIVITY = {ON|OFF}

Argumente

  • catalog_name
    Der Name des neuen Katalogs. Der Katalogname muss für alle Katalognamen in der aktuellen Datenbank eindeutig sein. Zudem muss der Name der Datei, die dem Volltextkatalog entspricht (siehe ON FILEGROUP), für alle Dateien in der Datenbank eindeutig sein. Wenn der Name des Katalogs bereits für einen anderen Katalog in der Datenbank verwendet wird, wird von SQL Server ein Fehler zurückgegeben.

    Der Katalogname darf maximal 120 Zeichen enthalten.

  • ON FILEGROUP 'filegroup'
    Der Name der SQL Server-Dateigruppe, in der der neue Katalog enthalten sein wird. Falls keine Dateigruppe angegeben ist, ist der neue Katalog Teil der Standarddateigruppe, die für alle Volltextkataloge verwendet wird. Standardmäßig wird die primäre Dateigruppe der Datenbank als Volltextdateigruppe verwendet. Es wird empfohlen, Volltextkataloge in einer sekundären Dateigruppe zu platzieren. Auf diese Weise können Sie Dateigruppen-Sicherungsvorgänge und Dateigruppen-Wiederherstellungsvorgänge von Volltextkatalogen unabhängig von den Daten- und Protokolldateien ausführen. Außerdem ermöglicht das Platzieren der Volltextkataloge in einer sekundären Dateigruppe das Wiederherstellen eines Online-Volltextkatalogs.

    In der Dateigruppe, in der der Volltextkatalog erstellt wird, muss mindestens eine verfügbare Datendatei enthalten sein. Diese Datendatei wird für interne Strukturen verwendet, die Teil des Volltextkatalogs sind. Diese in SQL Server gespeicherte Datei darf nicht mit OFFLINE oder READONLY gekennzeichnet sein.

    Die Kataloge in einer Dateigruppe werden wie Dateien behandelt, und ihr physikalischer Speicherort wird durch den Pfad in sys.master_files angezeigt. Der Name der für jeden Volltextkatalog erstellten Datei besteht aus der Kombination sysft_ und Katalogname. Wenn der Katalogname beispielseise catname lautet, lautet der Name der Datei, die diesem Katalog entspricht, sysft_catname.

  • IN PATH 'rootpath'
    Das Stammverzeichnis für den Katalog. Wenn rootpath nicht angegeben wird, wird der neue Katalog in dem beim Setup angegebenen Standardverzeichnis gespeichert.

    Volltextkataloge müssen auf einer lokalen Festplatte erstellt werden, die einer Instanz von SQL Server zugeordnet ist. rootpath darf kein relativer Pfad sein. Es muss ein Laufwerk auf demselben Computer verwendet werden. Obwohl Sie das Stammverzeichnis eines Laufwerks (z. B. 'C:\') als Speicherort eines Volltextkatalogs angeben können, wird dies jedoch nicht empfohlen. Netzlaufwerke, austauschbare Laufwerke, Disketten und UNC-Pfade (Universal Naming Convention) werden nicht unterstützt. In einer Failover-Clusterumgebung muss sich der Pfad auf einem freigegebenen Datenträger befinden, von dem die SQL Server-Ressource abhängig ist.

    Wenn der Name eines vorhandenen Volltextkatalogs mit einem falschen Pfad angegeben wird, wird von SQL Server ein Fehler zurückgegeben, und der Volltextkatalog wird nicht erstellt. Wenn der angegebene Wert für rootpath nicht vorhanden ist, wird von SQL Server ein Fehler mit dem Hinweis zurückgegeben, dass der Pfad nicht vorhanden ist.

    Sie können differenzielle Sicherungen und die Wiederherstellung von Volltextkatalogen ermöglichen, indem Sie den Volltextkatalog in einem Verzeichnis speichern, das Teil eines NTFS-Dateisystems ist. Differenzielle Sicherungen und die Wiederherstellung werden in anderen Dateisystemen als NTFS nicht unterstützt.

    Der Volltextkatalog wird als Verzeichnis im angegebenen Stammpfad erstellt. Als Verzeichnisname wird der Name des Volltextkatalogs erstellt. Wenn bereits ein Verzeichnis mit dem Namen des Katalogs vorhanden ist, wird ein Suffix an den Namen des Katalogs angefügt, und ein neues Verzeichnis mit diesem Namen wird erstellt.

    Das Erstellen von Volltextkatalogen im Stammverzeichnis eines Laufwerkes wie z. B. c:\ wird nicht empfohlen.

  • ACCENT_SENSITIVITY = {ON|OFF}
    Gibt an, ob für den Katalog bei der Volltextindizierung nach Akzent unterschieden wird. Bei einer Änderung dieser Eigenschaft muss der Index neu erstellt werden. Standardmäßig wird die in der Datenbanksortierung angegebene Unterscheidung nach Akzent verwendet. Die Datenbanksortierung kann in der sys.databases-Katalogsicht angezeigt werden.

    Verwenden Sie die FULLTEXTCATALOGPROPERTY-Funktion mit dem accentsensitivity-Eigenschaftswert für catalog_name, um die aktuelle Eigenschaftseinstellung für die Unterscheidung nach Akzent eines Volltextkatalogs zu bestimmen. Wird '1' zurückgegeben, unterscheidet der Volltextkatalog nach Akzent. Wird '0' zurückgegeben, unterscheidet der Katalog nicht nach Akzent.

  • AS DEFAULT
    Gibt an, dass der Katalog als Standardkatalog verwendet wird. Wenn beim Erstellen von Volltextindizes nicht explizit ein Volltextkatalog angegeben wird, wird der Standardkatalog verwendet. Falls ein vorhandener Volltextkatalog bereits mit AS DEFAULT gekennzeichnet ist, wird durch das Festlegen von AS DEFAULT für den neuen Katalog dieser Katalog als standardmäßiger Volltextkatalog verwendet.

  • AUTHORIZATION owner_name
    Legt den Namen eines Datenbankbenutzers oder einer Datenbankrolle als Besitzer des Volltextkatalogs fest. Wenn für owner_name eine Rolle angegeben ist, muss dies der Name einer Rolle sein, deren Mitglied der aktuelle Benutzer ist. Oder der Benutzer, der die Anweisung ausführt, muss der Datenbankbesitzer oder Systemadministrator sein.

    Wenn ein Benutzername für owner_name angegeben ist, muss es sich um einen der folgenden Benutzernamen handeln:

    • Den Namen des Benutzers, der die Anweisung ausführt.
    • Den Namen eines Benutzers, für den der Benutzer, der den Befehl ausführt, IMPERSONATE-Berechtigungen besitzt.
    • Oder der Benutzer, der den Befehl ausführt, muss der Datenbankbesitzer oder Systemadministrator sein.

    owner_name muss zudem über die TAKE OWNERSHIP-Berechtigung im angegebenen Volltextkatalog verfügen.

Berechtigungen

Der Benutzer muss über die CREATE FULLTEXT CATALOG-Berechtigung in der Datenbank verfügen oder ein Mitglied der festen Datenbankrolle db_owner oder db_ddladmin sein.

Beispiele

Im folgenden Beispiel werden ein Volltextkatalog und ein Volltextindex erstellt.

USE AdventureWorks;
GO
CREATE FULLTEXT CATALOG ftCatalog AS DEFAULT;
GO
CREATE FULLTEXT INDEX ON HumanResources.JobCandidate(Resume) KEY INDEX PK_JobCandidate_JobCandidateID;
GO

Siehe auch

Verweis

ALTER FULLTEXT CATALOG (Transact-SQL)
DROP FULLTEXT CATALOG (Transact-SQL)

Andere Ressourcen

Volltextsuche
Neuer Volltextkatalog (Seite Allgemein)

Hilfe und Informationen

Informationsquellen für SQL Server 2005