CREATE SEARCH PROPERTY LIST (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankAzure 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 existiert, CREATE SEARCH PROPERTY LIST scheitert sie mit einem Fehler. 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 Eigentümer kann mit der ALTER AUTHORIZATIONTransact-SQL-Erklärung 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.

Eine CREATE SEARCH PROPERTY LIST Aussage scheitert unter einer der folgenden Bedingungen:

  • 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

Benötigt CREATE FULLTEXT CATALOG Berechtigungen in der aktuellen Datenbank und REFERENZ-Berechtigungen für jede Datenbank, aus der man eine Quelleigenschaftsliste kopiert.

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. Das Beispiel verwendet dann eine ALTER FULLTEXT INDEX Anweisung, um die neue Eigenschaftsliste mit dem Volltextindex der Production.Document Tabelle in der AdventureWorks Datenbank zu verknüpfen, ohne eine Population zu starten.

Hinweis

Für ein Beispiel, das dieser Sucheigenschaftsliste mehrere vordefinierte, bekannte Sucheigenschaften hinzufügt, siehe ALTER SEARCH PROPERTY LIST (Transact-SQL). Nachdem Sucheigenschaften zur Liste hinzugefügt wurden, müsste der Datenbankadministrator eine weitere ALTER FULLTEXT INDEX Anweisung mit der Klausel START FULL POPULATION 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 AdventureWorks2025 zugeordnet ist. Das Beispiel verwendet dann eine ALTER FULLTEXT INDEX Anweisung, um die neue Eigenschaftsliste mit dem Volltextindex der HumanResources.JobCandidate Tabelle in der AdventureWorks2025 Datenbank zu verknüpfen. Diese ALTER FULLTEXT INDEX Anweisung startet eine vollständige Population, was das Standardverhalten der SETSEARCH PROPERTY LIST Klausel ist.

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

  • Last updated on