sp_help_fulltext_catalogs_cursor (Transact-SQL)

發行項
06/18/2013

利用資料指標來傳回指定全文檢索目錄之全文檢索索引資料表的識別碼、名稱、根目錄、狀態和數目。

重要事項
未來的 Microsoft SQL Server 版本將移除這項功能。請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。請改用 sys.fulltext_catalogs 目錄檢視。

主題連結圖示 Transact-SQL 語法慣例

語法

sp_help_fulltext_catalogs_cursor [ @cursor_return= ] @cursor_variable OUTPUT , 
     [ @fulltext_catalog_name = ] 'fulltext_catalog_name'

引數

[ @cursor_return=] @cursor\_variable OUTPUT
這是 cursor 類型的輸出變數。這個資料指標是可捲動的唯讀動態資料指標。
[ @fulltext_catalog_name=] 'fulltext_catalog_name'
這是全文檢索目錄的名稱。 fulltext_catalog_name 是 sysname。如果這個參數省略或是 NULL，就會傳回與目前資料庫相關聯之所有全文檢索目錄的相關資訊。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

資料行名稱	資料類型	說明
fulltext_catalog_id	smallint	全文檢索目錄識別碼。
NAME	sysname	全文檢索目錄的名稱。
PATH	nvarchar(260)	從 SQL Server 2008 開始，這個子句不會有任何作用。
STATUS	int	目錄的全文檢索索引擴展狀態： 0 = 閒置 1 = 完整母體擴展進行中 2 = 已暫停 3 = 調整執行速度 4 = 復原中 5 = 已關閉 6 = 累加母體擴展進行中 7 = 正在建立索引 8 = 磁碟已滿，已暫停 9 = 變更追蹤
NUMBER_FULLTEXT_TABLES	int	與目錄相關聯之全文檢索索引資料表的數目。

權限

執行權限預設會授與給 public 角色。

範例

下列範例會傳回 Cat_Desc 全文檢索目錄的相關資訊。

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