CREATE FULLTEXT CATALOG (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

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 den Datenbanken master, model oder tempdb kann kein Volltextkatalog erstellt werden.

Wichtig

Ab SQL Server 2008 (10.0.x) stellt ein Volltextkatalog ein virtuelles Objekt dar, das keiner Dateigruppe angehört. Ein Volltextkatalog ist ein logisches Konzept, das auf eine Gruppe von Volltextindizes verweist.

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}  
  

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

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, gibt SQL Server einen Fehler zurück.

Der Katalogname darf maximal 120 Zeichen enthalten.

ON FILEGROUP filegroup
Ab SQL Server 2008 (10.0.x) hat diese Klausel keine Auswirkungen mehr.

IN PATH 'rootpath'

Hinweis

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden.

Ab SQL Server 2008 (10.0.x) hat diese Klausel keine Auswirkungen mehr.

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.

Hinweise

Volltextkatalog-IDs beginnen bei 00005 und werden mit jedem neu erstellten Katalog um eins erhöht.

Berechtigungen

Der Benutzer muss über die CREATE FULLTEXT CATALOG-Berechtigung für die 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 AdventureWorks2022;  
GO  
CREATE FULLTEXT CATALOG ftCatalog AS DEFAULT;  
GO  
CREATE FULLTEXT INDEX ON HumanResources.JobCandidate(Resume) KEY INDEX PK_JobCandidate_JobCandidateID;  
GO  

Siehe auch