CREATE SEARCH PROPERTY LIST (Transact-SQL)

项目
06/18/2013

创建新的搜索属性列表。搜索属性列表用于指定要在全文索引中包括的一个或多个搜索属性。

重要提示
仅在兼容性级别 110 支持 CREATE SEARCH PROPERTY LIST、ALTER SEARCH PROPERTY LIST 和 DROP SEARCH PROPERTY LIST。在更低的兼容性级别中，不支持这些语句。

主题链接图标 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 所指定的数据库中的现有用户 ID 关联。您还必须对数据库拥有必需的权限。
source_list_name
指定通过从 database_name 中复制现有属性列表来创建新属性列表。如果 source_list_name 不存在，CREATE SEARCH PROPERTY LIST 将失败并出现错误。 source_list_name 中的搜索属性由 new_list_name 继承。
AUTHORIZATION owner_name
指定要拥有属性列表的用户或角色的名称。 owner_name 必须是当前用户所属的角色的名称，或当前用户必须具有对 owner_name 的 IMPERSONATE 权限。如果未指定，则所有权授予当前用户。

注意

可使用 ALTER AUTHORIZATION Transact-SQL 语句更改该所有者。

注意
可使用 ALTER AUTHORIZATION Transact-SQL 语句更改该所有者。

注释

注意
有关属性列表的一般信息，请参阅使用搜索属性列表搜索文档属性。

默认情况下，新的搜索属性列表为空，必须手动对其进行修改，以添加一个或多个搜索属性。或者，您也可以复制现有的搜索属性列表。在此情况下，新列表将继承其源的搜索属性，但您可以修改新列表，以添加或删除搜索属性。在下一次完全填充时搜索属性列表中的所有属性都将包括在全文索引中。

在以下任一情况下，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 权限。

注意
若要将列表与全文索引关联，需要拥有 REFERENCE 权限。若要添加和移除属性或删除列表，需要拥有 CONTROL 权限。属性列表所有者可以授予对列表的 REFERENCE 或 CONTROL 权限。拥有 CONTROL 权限的用户还可以向其他用户授予 REFERENCES 权限。

示例

A.创建空属性列表并将其与索引关联

以下示例创建名为 DocumentPropertyList 的新搜索属性列表。该示例然后使用 ALTER FULLTEXT INDEX 语句将新属性列表与 AdventureWorks 数据库中 Production.Document 表的全文索引关联，但不开始填充。

注意
有关将多个预定义的知名搜索属性添加到此搜索属性列表的示例，请参阅 ALTER SEARCH PROPERTY LIST (Transact-SQL)。在向列表中添加搜索属性后，数据库管理员将需要使用另一个带有 START FULL POPULATION 子句的 ALTER FULLTEXT INDEX 语句。

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

B.基于现有属性列表创建属性列表

以下示例基于示例 A 创建的列表 DocumentPropertyList（它与 AdventureWorks 数据库中的全文索引关联）创建一个新的搜索属性列表 JobCandidateProperties。然后，该示例使用 ALTER FULLTEXT INDEX 语句将新属性列表与 AdventureWorks 数据库中 HumanResources.JobCandidate 表的全文索引关联。此 ALTER FULLTEXT INDEX 语句启动完全填充，这是 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