sp_help_fulltext_columns_cursor (Transact-SQL)

适用于SQL Server

使用游标返回为全文索引指派的列。

重要

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

Transact-SQL 语法约定

语法

sp_help_fulltext_columns_cursor
    [ @cursor_return = ] cursor_return OUTPUT
    [ , [ @table_name = ] N'table_name' ]
    [ , [ @column_name = ] N'column_name' ]
[ ; ]

参数

[ @cursor_return = ] cursor_return OUTPUT

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

[ @table_name = ] N'table_name'

为其请求全文索引信息的一部分或两部分表名。 @table_name为 nvarchar(517),默认值为 NULL.

如果 省略@table_name ,则会为每个全文索引表检索全文索引列信息。

[ @column_name = ] N'column_name'

需要全文索引元数据的列的名称。 @column_name为 sysname,默认值为 NULL. 如果省略或省NULL略@column_name,则会为@table_name的每个全文索引列返回全文列信息。

如果 也省略@table_name 或为 NULL全文索引列信息,则会为数据库中所有表的每个全文索引列返回全文索引列信息。

返回代码值

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

结果集

列名称 数据类型 描述
TABLE_OWNER sysname 表所有者。 所有者是创建表的数据库用户的名称。
TABLE_ID int 表的 ID。
TABLE_NAME sysname 表名。
FULLTEXT_COLUMN_NAME sysname 为索引指定的全文索引表中的列。
FULLTEXT_COLID int 全文索引列的列 ID。
FULLTEXT_BLOBTP_COLNAME sysname 全文索引表中指定全文索引列文档类型的列。 仅当全文索引列是 varbinary(max)图像 列时,此值才适用。
FULLTEXT_BLOBTP_COLID int 文档类型列的列 ID。 仅当全文索引列是 varbinary(max)图像 列时,此值才适用。
FULLTEXT_LANGUAGE sysname 用于对列进行全文索引的语言。

权限

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

示例

以下示例返回有关为数据库中所有表的全文索引指定的列的信息。

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