sp_help_fulltext_catalogs_cursor (Transact-SQL)

适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例

使用游标返回指定的全文目录的 ID、名称、根目录、状态和全文索引表的数量。

重要

在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。 请改用 sys.fulltext_catalogs 目录视图。

Transact-SQL 语法约定

语法

  
sp_help_fulltext_catalogs_cursor [ @cursor_return= ] @cursor_variable OUTPUT ,   
     [ @fulltext_catalog_name = ] 'fulltext_catalog_name'   

参数

[ @cursor_return = ] @cursor_variable OUTPUT游标类型的输出变量。 游标是只读的可滚动动态游标。

[ @fulltext_catalog_name = ] 'fulltext_catalog_name' 全文目录的名称。 fulltext_catalog_name为 sysname。 如果省略该参数或该参数值为 NULL,则返回与当前数据库关联的所有全文目录的信息。

返回代码值

0(成功)或 1(失败)

结果集

列名称 数据类型 描述
fulltext_catalog_id smallint 全文目录的标识符。
NAME sysname 全文目录的名称。
PATH nvarchar(260) 从 SQL Server 2008 (10.0.x) 开始,此子句不再起作用。
地位 int 目录的全文索引填充状态:

0 = 空闲

1 = 正在进行完全填充

2 = 已暂停

3 = 已中止

4 = Recovering

5 = 关闭

6 = 正在进行增量填充

7 = 正在生成索引

8 = 磁盘已满。 已暂停

9 = 更改跟踪
NUMBER_FULLTEXT_TABLES int 与目录关联的全文索引表的数量。

权限

执行权限默认为 公共 角色。

示例

下面的示例返回有关 Cat_Desc 全文目录的信息。

USE AdventureWorks2022;  
GO  
DECLARE @mycursor CURSOR;  
EXEC sp_help_fulltext_catalogs_cursor @mycursor OUTPUT, 'Cat_Desc';  
FETCH NEXT FROM @mycursor;  
WHILE (@@FETCH_STATUS <> -1)  
   BEGIN  
      FETCH NEXT FROM @mycursor;  
   END  
CLOSE @mycursor;  
DEALLOCATE @mycursor;  
GO   

另请参阅

FULLTEXTCATALOGPROPERTY (Transact-SQL)
sp_fulltext_catalog (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)
系统存储过程 (Transact-SQL)