分享方式：

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） 。

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。

  • 如果 省略@fulltext_catalog_name 或 為 NULL，則會傳回與資料庫相關聯的所有全文檢索索引數據表。

  • 如果 指定@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識別之唯一索引的數據行標識碼。
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

相關內容