CREATE SEARCH PROPERTY LIST (Transact-SQL)

  • Artikel

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance

Erstellt eine neue Sucheigenschaftenliste. Mit einer Sucheigenschaftenliste können eine oder mehrere Sucheigenschaften angegeben werden, die Sie in einen Volltextindex einschließen möchten.

Transact-SQL-Syntaxkonventionen

Syntax

CREATE SEARCH PROPERTY LIST new_list_name  
   [ FROM [ database_name. ] source_list_name ]  
   [ AUTHORIZATION owner_name ]  
;

Argumente

new_list_name
Der Name der neuen Sucheigenschaftenliste. new_list_name ist ein Bezeichner mit maximal 128 Zeichen. new_list_name muss innerhalb aller Eigenschaftenlisten in der aktuellen Datenbank eindeutig sein und den Regeln für Bezeichner entsprechen. new_list_name wird verwendet, wenn der Volltextindex erstellt wird.

database_name
Der Name der Datenbank, in der sich die durch source_list_name festgelegte Eigenschaftenliste befindet. Wird database_name nicht angegeben, wird standardmäßig die aktuelle Datenbank verwendet.

database_name muss dem Namen einer vorhandenen Datenbank entsprechen. Die Anmeldung für die aktuelle Verbindung muss einer vorhandenen Benutzer-ID in der durch database_name festgelegte Datenbank zugeordnet sein. Sie müssen zudem über die erforderlichen Berechtigungen für die Datenbank verfügen.

source_list_name
Legt fest, dass die neue Eigenschaftenliste erstellt wird, indem eine vorhandene Eigenschaftenliste aus database_name kopiert wird. Wenn source_list_name nicht vorhanden ist, tritt bei CREATE SEARCH PROPERTY LIST ein Fehler auf. Die Sucheigenschaften in source_list_name werden von new_list_name geerbt.

AUTHORIZATION owner_name
Gibt den Namen eines Benutzers oder einer Rolle als Besitzer der Eigenschaftenliste an. owner_name muss der Name einer Rolle sein, deren Mitglied der aktuelle Benutzer ist, oder der aktuelle Benutzer benötigt die IMPERSONATE-Berechtigung für owner_name. Wird kein Wert angegeben, wird der aktuelle Benutzer zum Besitzer.

Hinweis

Der Besitzer kann mithilfe der Transact-SQL-Anweisung ALTER AUTHORIZATION geändert werden.

Hinweise

Hinweis

Allgemeine Informationen zu Eigenschaftenlisten finden Sie unter Suchen von Dokumenteigenschaften mithilfe von Sucheigenschaftenlisten.

Standardmäßig sind neue Sucheigenschaftenlisten leer, und Sie müssen diesen manuell Sucheigenschaften hinzufügen. Sie können jedoch auch eine vorhandene Sucheigenschaftenliste kopieren. In diesem Fall erbt die neue Liste die Sucheigenschaften ihrer Quelle. Sie können die neue Liste jedoch ändern und Sucheigenschaften hinzufügen oder entfernen. Alle Eigenschaften, die zur Zeit der nächsten vollständigen Auffüllung in der Sucheigenschaftenliste vorhanden sind, werden in den Volltextindex aufgenommen.

Unter jeder der folgenden Bedingungen tritt bei einer CREATE SEARCH PROPERTY LIST-Anweisung ein Fehler auf:

  • Die durch database_name festgelegte Datenbank ist nicht vorhanden.

  • Die durch source_list_name festgelegte Liste ist nicht vorhanden.

  • Wenn Sie nicht über die erforderlichen Berechtigungen verfügen.

So fügen Sie einer Liste Eigenschaften hinzu oder entfernen sie aus einer Liste:

Berechtigungen

Erfordert CREATE FULLTEXT CATALOG-Berechtigungen in der aktuellen Datenbank sowie REFERENCES-Berechtigungen für jede Datenbank, aus der Sie eine Quelleigenschaftenliste kopieren.

Hinweis

Die REFERENCES-Berechtigung ist erforderlich, um die Liste einem Volltextindex zuzuordnen. Die CONTROL-Berechtigung ist erforderlich, um Eigenschaften hinzuzufügen und zu entfernen oder die Liste zu löschen. REFERENCES-Berechtigungen oder CONTROL-Berechtigungen für die Liste können vom Besitzer der Eigenschaftenliste gewährt werden. Benutzer mit CONTROL-Berechtigung können anderen Benutzern auch eine REFERENCES-Berechtigung erteilen.

Beispiele

A. Erstellen einer leeren Eigenschaftenliste und Zuordnen zu einem Index

Im folgenden Beispiel wird die neue Sucheigenschaftenliste DocumentPropertyList erstellt. Im Beispiel wird dann dem Volltextindex der Production.Document-Tabelle in der AdventureWorks-Datenbank die neue Eigenschaftenliste mithilfe einer ALTER FULLTEXT INDEX-Anweisung zugewiesen, ohne eine Auffüllung zu starten.

Hinweis

Ein Beispiel, in dem dieser Sucheigenschaftenliste mehrere vordefinierte, bekannte Sucheigenschaften hinzugefügt werden, finden Sie unter ALTER SEARCH PROPERTY LIST (Transact-SQL). Wenn der Liste Sucheigenschaften hinzugefügt wurden, muss der Datenbankadministrator eine weitere ALTER FULLTEXT INDEX-Anweisung mit der START FULL POPULATION-Klausel verwenden.

CREATE SEARCH PROPERTY LIST DocumentPropertyList;  
GO  
USE AdventureWorks2022;  
ALTER FULLTEXT INDEX ON Production.Document   
   SET SEARCH PROPERTY LIST DocumentPropertyList  
   WITH NO POPULATION;   
GO

B. Erstellen einer Eigenschaftenliste aus einer vorhandenen

Im folgenden Beispiel wird die neue Sucheigenschaftenliste JobCandidateProperties aus der in Beispiel A erstellten Liste DocumentPropertyList erstellt, die einem Volltextindex in der Datenbank AdventureWorks2022 zugeordnet ist. Das Beispiel ordnet dann dem Volltextindex der HumanResources.JobCandidate-Tabelle in der AdventureWorks2022-Datenbank die neue Eigenschaftenliste mithilfe einer ALTER FULLTEXT INDEX-Anweisung zu. Mit dieser ALTER FULLTEXT INDEX-Anweisung wird eine vollständige Auffüllung gestartet, die das Standardverhalten der SET SEARCH PROPERTY LIST-Klausel darstellt.

CREATE SEARCH PROPERTY LIST JobCandidateProperties 
FROM AdventureWorks2022.DocumentPropertyList;  
GO  
ALTER FULLTEXT INDEX ON HumanResources.JobCandidate   
   SET SEARCH PROPERTY LIST JobCandidateProperties;  
GO

Siehe auch

ALTER SEARCH PROPERTY LIST (Transact-SQL)
DROP SEARCH PROPERTY LIST (Transact-SQL)
sys.registered_search_properties (Transact-SQL)
sys.registered_search_property_lists (Transact-SQL)
sys.dm_fts_index_keywords_by_property (Transact-SQL)
Suchen von Dokumenteigenschaften mithilfe von Sucheigenschaftenlisten
Suchen von Eigenschaftensatz-GUIDS und ganzzahligen Eigenschaft-IDs für Sucheigenschaften