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

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL DatabaseSe aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) SíAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database

Crea una nueva lista de propiedades de búsqueda.Creates a new search property list. Una lista de propiedades de búsqueda se utiliza para especificar una o más propiedades de búsqueda que desea incluir en un índice de texto completo.A search property list is used to specify one or more search properties that you want to include in a full-text index.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

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

Nota

Para ver la sintaxis de Transact-SQL para SQL Server 2014 y versiones anteriores, consulte Versiones anteriores de la documentación.To view Transact-SQL syntax for SQL Server 2014 and earlier, see Previous versions documentation.

ArgumentosArguments

new_list_namenew_list_name
Es el nombre de la nueva lista de propiedades de búsqueda.Is the name of the new search property list. new_list_name es un identificador con un máximo de 128 caracteres.new_list_name is an identifier with a maximum of 128 characters. new_list_name debe ser único entre todas las listas de propiedades de la base de datos actual y cumplir las reglas de los identificadores.new_list_name must be unique among all property lists in the current database, and conform to the rules for identifiers. new_list_name se usará cuando se cree el índice de texto completo.new_list_name will be used when the full-text index is created.

database_namedatabase_name
Es el nombre de la base de datos donde se encuentra la lista de propiedades especificada por source_list_name.Is the name of the database where the property list specified by source_list_name is located. Si no se especifica, database_name usa de manera predeterminada la base de datos actual.If not specified, database_name defaults to the current database.

database_name debe especificar el nombre de una base de datos existente.database_name must specify the name of an existing database. El inicio de sesión de la conexión actual debe estar asociado a un identificador de usuario existente en la base de datos especificada por database_name.The login for the current connection must be associated with an existing user ID in the database specified by database_name. También debe tener los permisos necesarios en la base de datos.You must also have the required permissions on the database.

source_list_namesource_list_name
Especifica que la nueva lista de propiedades se crea copiando una lista de propiedades existente desde database_name.Specifies that the new property list is created by copying an existing property list from database_name. Si source_list_name no existe, CREATE SEARCH PROPERTY LIST produce un error.If source_list_name does not exist, CREATE SEARCH PROPERTY LIST fails with an error. new_list_name hereda las propiedades de búsqueda de source_list_name.The search properties in source_list_name are inherited by new_list_name.

AUTHORIZATION owner_nameAUTHORIZATION owner_name
Especifica el nombre de un usuario o rol que posea la lista de propiedades.Specifies the name of a user or role to own of the property list. owner_name debe ser el nombre de un rol del que el usuario actual sea miembro, o bien el usuario actual debe tener el permiso IMPERSONATE sobre 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. Si no se especifica, la propiedad se otorga al usuario actual.If not specified, ownership is given to the current user.

Nota

El propietario se puede cambiar usando la instrucción Transact-SQLTransact-SQLALTER AUTHORIZATION.The owner can be changed by using the ALTER AUTHORIZATIONTransact-SQLTransact-SQL statement.

ComentariosRemarks

Nota

Para más información sobre las listas de propiedades en general, vea Buscar propiedades de documento con listas de propiedades de búsqueda.For information about property lists in general, see Search Document Properties with Search Property Lists.

De forma predeterminada, una nueva lista de propiedades de búsqueda está vacía y debe modificarla para agregar manualmente una o más propiedades de búsqueda.By default, a new search property list is empty and you must alter it to manually to add one or more search properties. Opcionalmente, puede copiar una lista de propiedades de búsqueda existente.Alternatively, you can copy an existing search property list. En este caso, la nueva lista hereda las propiedades de búsqueda de su origen, pero se puede modificar para agregar o quitar propiedades.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. Cualquier propiedad de la lista de propiedades de búsqueda en el momento del siguiente rellenado completo se incluye en el índice de texto completo.Any properties in the search property list at the time of the next full population are included in the full-text index.

Una instrucción CREATE SEARCH PROPERTY LIST da error en cualquiera de las condiciones siguientes:A CREATE SEARCH PROPERTY LIST statement fails under any of the following conditions:

  • Si la base de datos que especifica database_name no existe.If the database specified by database_name does not exist.

  • Si la lista que especifica source_list_name no existe.If the list specified by source_list_name does not exist.

  • Si no tiene los permisos correctos.If you do not have the correct permissions.

Para agregar o quitar las propiedades de una listaTo add or remove properties from a list

PermisosPermissions

Requiere los permisos CREATE FULLTEXT CATALOG en la base de datos actual y los permisos REERENCES en cualquier base de datos de la que copie una lista de propiedades de origen.Requires CREATE FULLTEXT CATALOG permissions in the current database and REFERENCES permissions on any database from which you copy a source property list.

Nota

El permiso REFERENCES se necesita para asociar la lista a un índice de texto completo.REFERENCES permission is required to associate the list with a full-text index. El permiso CONTROL se exige para agregar y quitar propiedades o quitar la lista.CONTROL permission is required to add and remove properties or drop the list. El propietario de la lista de propiedades puede conceder los permisos REFERENCE o CONTROL en la lista.The property list owner can grant REFERENCES or CONTROL permissions on the list. Los usuarios con el permiso CONTROL también pueden conceder el permiso REFERENCES a otros usuarios.Users with CONTROL permission can also grant REFERENCES permission to other users.

EjemplosExamples

A.A. Crear una lista de propiedades vacía y asociarla a un índiceCreating an empty property list and associating it with an index

El siguiente ejemplo crea una nueva lista de propiedades de búsqueda denominada DocumentPropertyList.The following example creates a new search property list named DocumentPropertyList. Luego, en el ejemplo se usa una instrucción ALTER FULLTEXT INDEX para asociar la nueva lista de propiedades al índice de texto completo de la tabla Production.Document en la base de datos AdventureWorks, sin iniciar un rellenado.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.

Nota

Para obtener un ejemplo en el que se agregan varias propiedades de búsqueda predefinidas conocidas a esta lista de propiedades de búsqueda, vea 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). Después de agregar las propiedades de búsqueda a la lista, el administrador de bases de datos necesitaría utilizar otra instrucción ALTER FULLTEXT INDEX con la cláusula START FULL POPULATION.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. Crear una lista de propiedades desde otra existenteCreating a property list from an existing one

El siguiente ejemplo crea una nueva lista de propiedades de búsqueda, JobCandidateProperties, a partir de la lista creada en el ejemplo A, DocumentPropertyList, que se asocia a un índice de texto completo en la base de datos AdventureWorks2012.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. A continuación, el ejemplo utiliza una instrucción ALTER FULLTEXT INDEX para asociar la nueva lista de propiedades al índice de texto completo de la tabla HumanResources.JobCandidate en la base de datos AdventureWorks2012.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. Esta instrucción ALTER FULLTEXT INDEX inicia un rellenado completo, que es el comportamiento predeterminado de la cláusula SET SEARCH PROPERTY LIST.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

Vea tambiénSee 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)
Buscar propiedades de documento con listas de propiedades de búsqueda Search Document Properties with Search Property Lists
Buscar GUID del conjunto de propiedades e identificadores de enteros de propiedad para las propiedades de búsquedaFind Property Set GUIDs and Property Integer IDs for Search Properties