sp_help_fulltext_tables_cursor (Transact-SQL)
适用于:SQL Server Azure SQL 托管实例 Analytics Platform System (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