sp_help_fulltext_catalogs_cursor (Transact-SQL)

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

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

重要

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

Transact-SQL 语法约定

语法

sp_help_fulltext_catalogs_cursor
    [ @cursor_return = ] cursor_return OUTPUT
    [ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
[ ; ]

参数

[ @cursor_return = ] cursor_return OUTPUT

@cursor_return是 int 类型的 OUTPUT 参数。游标是只读的、可滚动的动态游标。

[ @fulltext_catalog_name = ] N'fulltext_catalog_name'

全文目录的名称。 @fulltext_catalog_name为 sysname,默认值为 NULL. 如果省略此参数或为 NULL此参数,则返回与当前数据库关联的所有全文目录的相关信息。

返回代码值

0(成功)或 1(失败)。

结果集

列名称 数据类型 描述
fulltext_catalog_id smallint 全文目录的标识符。
NAME sysname 全文目录的名称。
PATH nvarchar(260) 此子句无效。
STATUS int 目录的全文索引填充状态:

0 = 空闲
1 = 正在进行中完全填充
2 = 已暂停
3 = 已限制
4 = 正在恢复
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