为全文索引对表进行标记或去除标记。
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。
下面的示例为 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'
当更改发生时,下面的示例激活并启动将所跟踪的更改传播到全文索引。USE Northwind
GO
EXEC sp_fulltext_table Categories, 'Start_change_tracking'
EXEC sp_fulltext_table Categories, 'Start_background_updateindex'
下面的示例为 Northwind 数据库的 Categories 表删除全文索引元数据。
USE Northwind
EXEC sp_fulltext_table 'Categories', 'drop'
相关文章