CREATE SEARCH PROPERTY LIST (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

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.

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 usará 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 usa 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 de 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 falla con 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. 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. Si no se especifica, la propiedad se otorga al usuario actual.

Nota

El propietario puede ser cambiado usando la ALTER AUTHORIZATION declaraciónTransact-SQL.

Comentarios

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.

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 CREATE SEARCH PROPERTY LIST afirmación falla bajo cualquiera de las siguientes condiciones:

  • 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

Permisos

Requiere CREATE FULLTEXT CATALOG permisos en la base de datos actual y permisos de REFERENCIAS en cualquier base de datos de la que copies una lista de propiedades fuente.

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. El ejemplo utiliza entonces una ALTER FULLTEXT INDEX sentencia para asociar la nueva lista de propiedades con el índice de texto completo de la Production.Document tabla en la AdventureWorks base de datos, sin iniciar una población.

Nota

Para un ejemplo que añade varias propiedades de búsqueda predefinidas y bien conocidas a esta lista de propiedades de búsqueda, véaseALTER SEARCH PROPERTY LIST (Transact-SQL). Tras añadir propiedades de búsqueda a la lista, el administrador de la base de datos tendría que usar otra ALTER FULLTEXT INDEX instrucción con la cláusula START FULL POPULATION.

CREATE SEARCH PROPERTY LIST DocumentPropertyList;  
GO  
USE AdventureWorks2022;  
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 AdventureWorks2025. El ejemplo utiliza entonces una ALTER FULLTEXT INDEX sentencia para asociar la nueva lista de propiedades con el índice de texto completo de la HumanResources.JobCandidate tabla en la AdventureWorks2025 base de datos. Esta ALTER FULLTEXT INDEX sentencia inicia una población completa, que es el comportamiento predeterminado de la SETSEARCH PROPERTY LIST cláusula.

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

Vea también

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)
Buscar propiedades de documento con listas de propiedades de búsqueda
Buscar GUID del conjunto de propiedades e identificadores de enteros de propiedad para las propiedades de búsqueda

  • Last updated on