通过

sp_help_fulltext_tables_cursor (Transact-SQL)

  • 项目

适用于： SQL Server Azure SQL 托管实例 分析平台系统 (PDW)

使用游标返回为全文索引注册的表的列表。

重要

在 SQL Server的未来版本中将删除此功能。 请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。 请改用新的 sys.fulltext_indexes 目录视图。 有关详细信息，请参阅 sys.fulltext_indexes。

Transact-SQL 语法约定

语法

sp_help_fulltext_tables_cursor
     [ @cursor_return = ] cursor_return OUTPUT
     [ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
     [ , [ @table_name = ] N'table_name' ]
[ ; ]

参数

[ @cursor_return = ] cursor_return OUTPUT

游标类型的输出变量。 游标是只读的可滚动动态游标。

[ @fulltext_catalog_name = ] N'fulltext_catalog_name'

全文目录的名称。 @fulltext_catalog_name为 sysname，默认值为 NULL.

  • 如果省略或省NULL略@fulltext_catalog_name，则返回与数据库关联的所有全文索引表。

  • 如果 指定了@fulltext_catalog_name ，但 省略@table_name ， NULL则检索与此目录关联的每个全文索引表的全文索引信息。

  • 如果同时指定了@fulltext_catalog_name和@table_name，则如果@table_name与 @fulltext_catalog_name 相关联，则返回一行;否则将引发错误。

[ @table_name = ] N'table_name'

为其请求全文元数据的一部分或两部分表名称。 @table_name为 nvarchar（517），默认值为 NULL. 如果仅 指定@table_name ，则仅返回与 @table_name 相关的行。

返回代码值

0（成功）或 1（失败）。

结果集

列名称 数据类型 描述
TABLE_OWNER sysname 表所有者。 这是创建该表的数据库用户的名称。
TABLE_NAME sysname 表名。
FULLTEXT_KEY_INDEX_NAME sysname 对指定为唯一键列的列施加 UNIQUE 约束的索引。
FULLTEXT_KEY_COLID int 标识 FULLTEXT_KEY_INDEX_NAME的唯一索引的列 ID。
FULLTEXT_INDEX_ACTIVE int 指定该表中为全文索引标记的列是否适于查询：

0 = 非活动
1 = 可用
FULLTEXT_CATALOG_NAME sysname 全文索引数据所在的全文目录。

权限

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

示例

以下示例返回与 Cat_Desc 全文目录相关联的全文索引表的名称。

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

相关内容