CREATE SEARCH PROPERTY LIST (Transact-SQL)

Artículo
06/18/2013

Crea una nueva lista de propiedades de búsqueda. 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.

Importante
CREATE SEARCH PROPERTY LIST, ALTER SEARCH PROPERTY LIST y DROP SEARCH PROPERTY LIST solo se admiten para un nivel de compatibilidad de 110. En niveles de compatibilidad menores, estas instrucciones no se admiten.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

new_list_name
Es el nombre de la nueva lista de propiedades de búsqueda. new_list_name es un identificador con un máximo de 128 caracteres. 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 se utilizará cuando se cree el índice de texto completo.
database_name
Es el nombre de la base de datos donde se encuentra la lista de propiedades especificada por source_list_name. Si no se especifica, database_name utiliza de manera predeterminada la base de datos actual.

database_name debe especificar el nombre de una base de datos existente. El inicio de sesión para la conexión actual debe estar asociado a un identificador de usuario existente en la base de datos especificada por database_name. También debe tener los permisos necesarios en la base de datos.
source_list_name
Especifica que la nueva lista de propiedades se crea copiando una lista de propiedades existente desde database_name. Si source_list_name no existe, CREATE SEARCH PROPERTY LIST produce un error. new_list_name hereda las propiedades de búsqueda de source_list_name.
AUTHORIZATION owner_name
Especifica el nombre de un usuario o rol que posea la lista de propiedades. El valor de owner_name debe ser el nombre de un rol del que el usuario actual sea miembro, o el usuario actual debe tener el permiso IMPERSONATE sobre owner_name. Si no se especifica, la propiedad se otorga al usuario actual.

[!NOTA]

El propietario se puede cambiar mediante la instrucción de Transact-SQL ALTER AUTHORIZATION.

Comentarios

[!NOTA]

Para obtener información acerca de las listas de propiedades en general, vea Buscar propiedades de documento con listas de propiedades de búsqueda.

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. Opcionalmente, puede copiar una lista de propiedades de búsqueda existente. En este caso, la nueva lista hereda las propiedades de búsqueda de su origen, pero se puede modificar para agregar o quitar propiedades. 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.

Una instrucción CREATE SEARCH PROPERTY LIST da error en cualquiera de las condiciones siguientes:

Si la base de datos que especifica database_name no existe.
Si la lista que especifica source_list_name no existe.
Si no tiene los permisos correctos.

Para agregar o quitar las propiedades de una lista

ALTER SEARCH PROPERTY LIST (Transact-SQL)
Para quitar una lista de propiedades
DROP SEARCH PROPERTY LIST (Transact-SQL)

Permisos

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.

[!NOTA]

El permiso REFERENCES se necesita para asociar la lista a un índice de texto completo. El permiso CONTROL se exige para agregar y quitar propiedades o quitar la lista. El propietario de la lista de propiedades puede conceder los permisos REFERENCE o CONTROL en la lista. Los usuarios con el permiso CONTROL también pueden conceder el permiso REFERENCES a otros usuarios.

Ejemplos

A.Crear una lista de propiedades vacía y asociarla a un índice

El siguiente ejemplo crea una nueva lista de propiedades de búsqueda denominada DocumentPropertyList. 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 Production.Document en la base de datos AdventureWorks, sin iniciar un rellenado.

[!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). 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.

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

B.Crear una lista de propiedades desde otra existente

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 AdventureWorks. 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 AdventureWorks. Esta instrucción ALTER FULLTEXT INDEX inicia un rellenado completo, que es el comportamiento predeterminado de la cláusula SET SEARCH PROPERTY LIST.

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