sp_fulltext_table

为全文索引对表进行标记或去除标记。

语法

sp_fulltext_table [ @tabname = ] 'qualified_table_name'
    , [ @action = ] 'action'
    [ , [ @ftcat = ] 'fulltext_catalog_name'
    , [ @keyname = ] 'unique_index_name' ]

参数

[@tabname =] 'qualified_table_name'

一段或两段的表名。该表必须存在于当前的数据库中。qualified_table_name 的数据类型为 nvarchar(517)，无默认值。

[@action =] 'action'

将要执行的动作。action 的数据类型为 varchar(20)，无默认值，可以是下面值中的一个。

值	描述
Create	为 qualified_table_name 引用的表创建全文索引的元数据，并且指定该表的全文索引数据应该驻留在 fulltext_catalog_name 中。该动作还将 unique_index_name 的用法指派为全文键列。这个唯一的索引必须已经存在，并且必须在表的某个列上已经定义。 完成全文目录填充后才能对该表执行全文检索。
Drop	对于 qualified_table_name，除去全文索引上的元数据。如果全文索引是活动的，那么在除去它之前会自动停用它。在除去全文索引之前，不必删除列。
Activate	停用全文索引后，激活为 qualified_table_name 聚集全文索引数据的能力。在激活全文索引之前，应该至少有一列参与这个全文索引。 一旦为索引添加了第一列，全文索引便自动成为活动的。如果从索引中除去最后一列，该索引将成为非活动的。如果打开更改跟踪，激活非活动的索引将会启动新填充。 请注意，这个动作并没有实际填充全文索引，只是将表注册在文件系统中的全文目录，这样，在进行下一次全文索引填充时，就可以检索来自 qualified_table_name 的行。
Deactivate	停用 qualified_table_name 的全文索引，使得无法再为 qualified_table_name 聚集全文索引数据。全文索引元数据依然保留，并且该表还可以被重新激活。 如果打开更改跟踪，停用一个活动的索引将会冻结索引状态：任何正在进行的填充都将停止，不再将更多的更改传播到索引。
start_change_tracking	启动全文索引的增量填充。如果该表没有时间戳，那么就启动全文索引的完全填充。开始跟踪表发生的变化。 全文更改跟踪不跟踪对类型为 image、text 或 ntext 的全文索引列所执行的任何 WRITETEXT 或 UPDATETEXT 操作。
stop_change_tracking	停止跟踪表发生的变化。
update_index	将当前一系列跟踪的变化传播到全文索引。
Start_background_updateindex	在变化发生时，开始将跟踪的变化传播到全文索引。
Stop_background_updateindex	在变化发生时，停止将跟踪的变化传播到全文索引。
start_full	启动表的全文索引的完全填充。
start_incremental	启动表的全文索引的增量填充。
停止	停止完全或增量填充。

[@ftcat =] 'fulltext_catalog_name'

是 create 动作有效的现有全文目录名。对于所有其它动作，该参数必须为 NULL。fulltext_catalog_name 的数据类型为 sysname，默认值为 NULL。

[@keyname =] 'unique_index_name'

有效的单键列，create 动作的 qualified_table_name 上的唯一的非空索引。对于所有其它动作，该参数必须为 NULL。unique_index_name 的数据类型为 sysname，默认值为 NULL。

返回代码值

0（成功）或 1（失败）

结果集

无

注释

为一个特定的表停用全文索引后，在下一次完全填充之前，现有的全文索引仍保留在原位；可是，由于 Microsoft® SQL Server™ 关闭了在停用表上的查询，所以不能使用该索引。

如果重新激活该表，而不重新填充索引，旧索引仍可用于对其余任何启用了全文索引的非新的列进行查询。删除列的数据在指定全部全文列 (*) 搜索的查询中相匹配。

为全文索引定义一个表后，把全文唯一键列从一个数据类型切换到另一个数据类型。切换方法可以是更改该列的数据类型，也可以是把全文唯一键从一列更改到另一列上。采用上述方法，在后续查询时，完全重新填充可能会引致失败并返回错误信息。"对于全文检索键值 key_value，转换到类型 data_type 失败。"为防止发生这种情况，使用 sp_fulltext_table 的"除去"动作为该表除去全文定义，并使用 sp_fulltext_table 和 sp_fulltext_column 对它进行重新定义。

如果全文唯一键列是个字符列或 Unicode 字符列，则必须将其定义为 450 字节或更少。

权限

只有 sysadmin 固定服务器角色成员、db_owner 和 db_ddladmin 固定数据库角色成员和对象所有者才能执行 sp_fulltext_table。

示例

A. 为全文索引启用表

下面的示例为 Northwind 数据库的 Categories 表创建全文索引元数据。Cat_Desc 是全文目录。PK_Categories 为 Categories 上唯一的、单列索引。

USE Northwind
EXEC sp_fulltext_table 'Categories', 'create', 'Cat_Desc', 'PK_Categories'
.. Add some columns
EXEC sp_fulltext_column 'Categories','Description','add'
.. Activate the index
EXEC sp_fulltext_table 'Categories','activate'

B. 激活并传播跟踪更改

当更改发生时，下面的示例激活并启动将所跟踪的更改传播到全文索引。
USE Northwind
GO
EXEC sp_fulltext_table Categories, 'Start_change_tracking'
EXEC sp_fulltext_table Categories, 'Start_background_updateindex'

C. 删除全文索引

下面的示例为 Northwind 数据库的 Categories 表删除全文索引元数据。

USE Northwind

EXEC sp_fulltext_table 'Categories', 'drop'

请参见

INDEXPROPERTY

OBJECTPROPERTY

sp_help_fulltext_tables

sp_help_fulltext_tables_cursor

sp_helpindex

系统存储过程