sp_help_fulltext_tables_cursor (Transact-SQL)

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

重要说明重要提示

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

主题链接图标Transact-SQL 语法约定

语法

sp_help_fulltext_tables_cursor [ @cursor_return = ] @cursor_variable OUTPUT 
     [ , [ @fulltext_catalog_name = ] 'fulltext_catalog_name' ] 
     [ , [ @table_name = ] 'table_name' ]

参数

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

  • [ @fulltext_catalog_name= ] 'fulltext_catalog_name'
    全文目录的名称。fulltext_catalog_name 的数据类型为 sysname,默认值为 NULL。如果 fulltext_catalog_name 未提供或为 NULL,则返回与该数据库相关联的所有全文索引表。如果指定 fulltext_catalog_name,但 table_name 未提供或为 NULL,则会针对每个与此目录相关联的全文索引表检索全文索引信息。如果同时指定了 fulltext_catalog_name 和 table_name,则在 table_name 与 fulltext_catalog_name 相关联时返回行;否则引发错误。

  • [ @table_name=] '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_NAME 标识的唯一索引的列 ID。

FULLTEXT_INDEX_ACTIVE

int

指定该表中为全文索引标记的列是否适于查询:

0 = 非活动

1 = 活动

FULLTEXT_CATALOG_NAME

sysname

全文索引数据所在的全文目录。

权限

执行权限默认授予 public 角色的成员。

示例

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

USE AdventureWorks;
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