CREATE SEARCH PROPERTY LIST (Transact-SQL)

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

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

Соглашения о синтаксисе 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. Если атрибут не указан, владельцем становится текущий пользователь.

Примечание.

Владельца можно сменить, используя ALTER AUTHORIZATIONTransact-SQL statement.

Замечания

Примечание.

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

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

Утверждение не CREATE SEARCH PROPERTY LIST работает при любом из следующих условий:

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

  • Если список, указанный параметром source_list_name, не существует.

  • Если отсутствуют нужные разрешения.

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

Разрешения

Требуется 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 POPULATIONE.

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

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

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

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

Связанные материалы

  • Last updated on