sp_fulltext_table (Transact-SQL)

语法

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 的数据类型为 nvarchar(50)，无默认值，可以是下列值之一。

  值	说明
  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	启动表的全文索引的增量填充。
  Stop	停止完全填充或增量填充。

• [ @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（失败）

结果集

无

注释

停用特定表的全文索引后，在下一次完全填充之前，现有的全文索引将留在原位；但是，由于 MicrosoftSQL Server 将阻止对停用的表的查询，所以不会使用该索引。

如果重新激活该表，但不重新填充索引，则仍可使用旧索引对剩余的启用了全文索引的非新列进行查询。在指定了完全全文列搜索的查询中，将匹配已删除的列中的数据。

定义了进行全文索引的表后，如果切换全文唯一键列的数据类型（通过更改该列的数据类型或更改全文唯一键列）时不完全重填，则可能导致后续查询失败，并返回以下错误消息：“将全文搜索键值 data_type 转换为 key_value 类型失败。”为了防止发生这种情况，可以使用 sp_fulltext_table 的 drop 操作删除此表的全文索引定义，然后使用 sp_fulltext_table 和 sp_fulltext_column 重新定义全文索引。

必须将全文键列定义为 900 字节或更少。考虑到性能原因，建议尽量使用较小的键列。

权限

只有 sysadmin 固定服务器角色、db_owner 和 db_ddladmin 固定数据库角色的成员，或对全文目录具有引用权限的用户才能执行 sp_fulltext_table。

示例

A. 启用要进行全文索引的表

USE AdventureWorks;
GO
EXEC sp_fulltext_table 'Production.Document', 'create', 'Cat_Desc', 'PK_Document_DocumentID';
--Add some columns
EXEC sp_fulltext_column 'Production.Document','DocumentSummary','add';
-- Activate the full-text index
EXEC sp_fulltext_table 'Production.Document','activate';
GO

B. 激活并传播跟踪更改

USE AdventureWorks;
GO
EXEC sp_fulltext_table 'Production.Document', 'Start_change_tracking';
EXEC sp_fulltext_table 'Production.Document', 'Start_background_updateindex';
GO

C. 删除全文索引

USE AdventureWorks;
GO
EXEC sp_fulltext_table 'Production.Document', 'drop';
GO

请参阅

参考