CREATE SEARCH PROPERTY LIST (Transact-SQL)CREATE SEARCH PROPERTY LIST (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2012)jaAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2012)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Erstellt eine neue Sucheigenschaftenliste.Creates a new search property list. Mit einer Sucheigenschaftenliste können eine oder mehrere Sucheigenschaften angegeben werden, die Sie in einen Volltextindex einschließen möchten.A search property list is used to specify one or more search properties that you want to include in a full-text index.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

new_list_namenew_list_name
Der Name der neuen Sucheigenschaftenliste.Is the name of the new search property list. new_list_name ist ein Bezeichner mit maximal 128 Zeichen.new_list_name is an identifier with a maximum of 128 characters. new_list_name muss innerhalb aller Eigenschaftenlisten in der aktuellen Datenbank eindeutig sein und den Regeln für Bezeichner entsprechen.new_list_name must be unique among all property lists in the current database, and conform to the rules for identifiers. new_list_name wird verwendet, wenn der Volltextindex erstellt wird.new_list_name will be used when the full-text index is created.

database_namedatabase_name
Der Name der Datenbank, in der sich die durch source_list_name festgelegte Eigenschaftenliste befindet.Is the name of the database where the property list specified by source_list_name is located. Wird database_name nicht angegeben, wird standardmäßig die aktuelle Datenbank verwendet.If not specified, database_name defaults to the current database.

database_name muss dem Namen einer vorhandenen Datenbank entsprechen.database_name must specify the name of an existing database. Die Anmeldung für die aktuelle Verbindung muss einer vorhandenen Benutzer-ID in der durch database_name festgelegte Datenbank zugeordnet sein.The login for the current connection must be associated with an existing user ID in the database specified by database_name. Sie müssen zudem über die erforderlichen Berechtigungen für die Datenbank verfügen.You must also have the required permissions on the database.

source_list_namesource_list_name
Legt fest, dass die neue Eigenschaftenliste erstellt wird, indem eine vorhandene Eigenschaftenliste aus database_name kopiert wird.Specifies that the new property list is created by copying an existing property list from database_name. Wenn source_list_name nicht vorhanden ist, tritt bei CREATE SEARCH PROPERTY LIST ein Fehler auf.If source_list_name does not exist, CREATE SEARCH PROPERTY LIST fails with an error. Die Sucheigenschaften in source_list_name werden von new_list_name geerbt.The search properties in source_list_name are inherited by new_list_name.

AUTHORIZATION owner_nameAUTHORIZATION owner_name
Gibt den Namen eines Benutzers oder einer Rolle als Besitzer der Eigenschaftenliste an.Specifies the name of a user or role to own of the property list. 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.owner_name must either be the name of a role of which the current user is a member, or the current user must have IMPERSONATE permission on owner_name. Wird kein Wert angegeben, wird der aktuelle Benutzer zum Besitzer.If not specified, ownership is given to the current user.

Hinweis

Der Besitzer kann mithilfe der ALTER AUTHORIZATION Transact-SQLTransact-SQL-Anweisung geändert werden.The owner can be changed by using the ALTER AUTHORIZATION Transact-SQLTransact-SQL statement.

RemarksRemarks

Hinweis

Allgemeine Informationen zu Eigenschaftenlisten finden Sie unter Suchen von Dokumenteigenschaften mithilfe von Sucheigenschaftenlisten.For information about property lists in general, see Search Document Properties with Search Property Lists.

Standardmäßig sind neue Sucheigenschaftenlisten leer, und Sie müssen diesen manuell Sucheigenschaften hinzufügen.By default, a new search property list is empty and you must alter it to manually to add one or more search properties. Sie können jedoch auch eine vorhandene Sucheigenschaftenliste kopieren.Alternatively, you can copy an existing search property list. 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.In this case, the new list inherits the search properties of its source, but you can alter the new list to add or remove search properties. Alle Eigenschaften, die zur Zeit der nächsten vollständigen Auffüllung in der Sucheigenschaftenliste vorhanden sind, werden in den Volltextindex aufgenommen.Any properties in the search property list at the time of the next full population are included in the full-text index.

Unter jeder der folgenden Bedingungen tritt bei einer CREATE SEARCH PROPERTY LIST-Anweisung ein Fehler auf:A CREATE SEARCH PROPERTY LIST statement fails under any of the following conditions:

BerechtigungenPermissions

Erfordert CREATE FULLTEXT CATALOG-Berechtigungen in der aktuellen Datenbank sowie REFERENCES-Berechtigungen für jede Datenbank, aus der Sie eine Quelleigenschaftenliste kopieren.Requires CREATE FULLTEXT CATALOG permissions in the current database and REFERENCES permissions on any database from which you copy a source property list.

Hinweis

Die REFERENCES-Berechtigung ist erforderlich, um die Liste einem Volltextindex zuzuordnen.REFERENCES permission is required to associate the list with a full-text index. Die CONTROL-Berechtigung ist erforderlich, um Eigenschaften hinzuzufügen und zu entfernen oder die Liste zu löschen.CONTROL permission is required to add and remove properties or drop the list. REFERENCES-Berechtigungen oder CONTROL-Berechtigungen für die Liste können vom Besitzer der Eigenschaftenliste gewährt werden.The property list owner can grant REFERENCES or CONTROL permissions on the list. Benutzer mit CONTROL-Berechtigung können anderen Benutzern auch eine REFERENCES-Berechtigung erteilen.Users with CONTROL permission can also grant REFERENCES permission to other users.

BeispieleExamples

A.A. Erstellen einer leeren Eigenschaftenliste und Zuordnen zu einem IndexCreating an empty property list and associating it with an index

Im folgenden Beispiel wird die neue Sucheigenschaftenliste DocumentPropertyList erstellt.The following example creates a new search property list named DocumentPropertyList. 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.The example then uses an ALTER FULLTEXT INDEX statement to associate the new property list with the full-text index of the Production.Document table in the AdventureWorks database, without starting a population.

Hinweis

Ein Beispiel, in dem dieser Sucheigenschaftenliste mehrere vordefinierte, bekannte Sucheigenschaften hinzugefügt werden, finden Sie unter ALTER SEARCH PROPERTY LIST (Transact-SQL).For an example that adds several predefined, well-known search properties to this search property list, see 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.After adding search properties to the list, the database administrator would need to use another ALTER FULLTEXT INDEX statement with the START FULL POPULATION clause.

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

B.B. Erstellen einer Eigenschaftenliste aus einer vorhandenenCreating a property list from an existing one

Im folgenden Beispiel wird die neue Sucheigenschaftenliste JobCandidateProperties aus der in Beispiel A erstellten Liste DocumentPropertyList erstellt, die einem Volltextindex in der Datenbank AdventureWorks2012 zugeordnet ist.The following example creates a new the search property list, JobCandidateProperties, from the list created by Example A, DocumentPropertyList, which is associated with a full-text index in the AdventureWorks2012 database. Das Beispiel ordnet dann dem Volltextindex der HumanResources.JobCandidate-Tabelle in der AdventureWorks2012-Datenbank die neue Eigenschaftenliste mithilfe einer ALTER FULLTEXT INDEX-Anweisung zu.The example then uses an ALTER FULLTEXT INDEX statement to associate the new property list with the full-text index of the HumanResources.JobCandidate table in the AdventureWorks2012 database. Mit dieser ALTER FULLTEXT INDEX-Anweisung wird eine vollständige Auffüllung gestartet, die das Standardverhalten der SET SEARCH PROPERTY LIST-Klausel darstellt.This ALTER FULLTEXT INDEX statement starts a full population, which is the default behavior of the SET SEARCH PROPERTY LIST clause.

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

Weitere Informationen finden Sie unterSee Also

ALTER SEARCH PROPERTY LIST (Transact-SQL) ALTER SEARCH PROPERTY LIST (Transact-SQL)
DROP SEARCH PROPERTY LIST (Transact-SQL) DROP SEARCH PROPERTY LIST (Transact-SQL)
sys.registered_search_properties (Transact-SQL) sys.registered_search_properties (Transact-SQL)
sys.registered_search_property_lists (Transact-SQL) sys.registered_search_property_lists (Transact-SQL)
sys.dm_fts_index_keywords_by_property (Transact-SQL) sys.dm_fts_index_keywords_by_property (Transact-SQL)
Suchen von Dokumenteigenschaften mithilfe von Sucheigenschaftenlisten Search Document Properties with Search Property Lists
Suchen von Eigenschaftensatz-GUIDS und ganzzahligen Eigenschaft-IDs für SucheigenschaftenFind Property Set GUIDs and Property Integer IDs for Search Properties