CREATE SEARCH PROPERTY LIST (Transact-SQL)

Статья
03/07/2014

Создает новый список свойств поиска. В списке свойств поиска указывается одно или несколько свойств поиска, которые необходимо включить в полнотекстовый индекс.

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2012 до текущей версии).

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

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

Аргументы

new_list_name
Имя нового списка свойств поиска. Аргумент new_list_name — это идентификатор с максимальной длиной в 128 символов. Имя аргумента new_list_name должно быть уникальным в списках свойств текущей базы данных и соответствовать правилам для идентификаторов. Аргумент new_list_name будет использоваться при создании полнотекстового индекса.
database_name
Имя базы данных, в которой находится список свойств, указанный параметром source_list_name. Если аргумент database_name не указан, по умолчанию список стоп-слов создается в текущей базе данных.

Параметр database_name должен указывать имя существующей базы данных. Имя входа для текущего соединения должно быть связано с идентификатором пользователя, существующим в базе данных, которая указана параметром database_name. Кроме того, требуются необходимые разрешения для базы данных.
source_list_name
Указывает, что новый список свойств создается путем копирования существующего списка свойств из database_name. Если source_list_name не существует, то инструкция CREATE SEARCH PROPERTY LIST завершится ошибкой. Свойства поиска из source_list_name наследуются new_list_name.
AUTHORIZATION owner_name
Указывает имя пользователя или роли-владельца списка свойств. Либо аргумент owner_name должен быть именем роли, членом которой является текущий пользователь, либо текущий пользователь должен иметь разрешение IMPERSONATE пользователя owner_name. Если атрибут не указан, владельцем становится текущий пользователь.

Примечание

Владельца можно изменить с помощью инструкции Transact-SQL ALTER AUTHORIZATION.

Замечания

Примечание

Общие сведения о списках свойств см. в разделе Поиск свойств документа с использованием списков свойств поиска.

По умолчанию новый список свойств, которые можно искать, пуст. В него необходимо вручную добавить одно или несколько свойств. В качестве альтернативы можно скопировать существующий список свойств поиска. В этом случае новый список наследует поисковые свойства своего источника, но его можно изменить, добавив или удалив определенные свойства. При следующем полном заполнении все свойства, приведенные в списке свойств поиска, заносятся в полнотекстовый индекс.

Инструкция CREATE SEARCH PROPERTY LIST завершится неуспехом при выполнении любого из следующих условий.

Если база данных, указанная параметром database_name, не существует.
Если список, указанный параметром source_list_name, не существует.
Если отсутствуют нужные разрешения.

Добавление и удаление свойств в списке

ALTER SEARCH PROPERTY LIST (Transact-SQL)
Удаление списка свойств
DROP SEARCH PROPERTY LIST (Transact-SQL)

Разрешения

Необходимы разрешения CREATE FULLTEXT CATALOG в текущей базе данных и разрешение REFERENCES для любой базы данных, из которой копируется исходный список свойств.

Примечание

Для связывания списка с полнотекстовым индексом требуется разрешение REFERENCES.Для добавления или удаления свойств, а также для удаления списка требуется разрешение CONTROL.Владелец списка свойств поиска может предоставить разрешения REFERENCES и CONTROL на список.Пользователи с разрешением CONTROL также могут предоставлять разрешение REFERENCES другим пользователям.

Примеры

А.Создание пустого списка свойств и связывание его с индексом

В следующем примере создается новый список свойств поиска с именем DocumentPropertyList. Затем инструкция ALTER FULLTEXT INDEX связывает новый список свойств с полнотекстовым индексом таблицы Production.Document из базы данных AdventureWorks без запуска заполнения.

Примечание

Пример, в котором в этот список свойств поиска добавляются несколько стандартных, известных свойств поиска, приведен в разделе ALTER SEARCH PROPERTY LIST (Transact-SQL).После добавления свойств поиска в список администратору базы данных необходимо будет использовать другую инструкцию ALTER FULLTEXT INDEX с предложением START FULL POPULATION.

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

Б.Создание нового списка свойств на основе существующего

В следующем примере создается новый список свойств поиска, JobCandidateProperties, из списка, созданного в примере A, DocumentPropertyList, который будет связан с полнотекстовым индексом из базы данных AdventureWorks2012. Затем инструкция ALTER FULLTEXT INDEX связывает новый список свойств с полнотекстовым индексом таблицы HumanResources.JobCandidate из базы данных AdventureWorks2012. Эта инструкция ALTER FULLTEXT INDEX начинает полное заполнение — поведением по умолчанию для предложения SET SEARCH PROPERTY LIST.

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