sp_help_fulltext_catalogs_cursor (Transact-SQL)

適用於:SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體

使用數據指標傳回指定全文檢索目錄的標識碼、名稱、根目錄、狀態和全文檢索索引數據表數目。

重要

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這是數據指標類型的輸出變數。 數據指標是只讀、可捲動的動態數據指標。

[ @fulltext_catalog_name = ] 'fulltext_catalog_name' 這是全文檢索目錄的名稱。 fulltext_catalog_name為 sysname。 如果省略此參數或為 NULL,則會傳回與目前資料庫相關聯之所有全文檢索目錄的相關信息。

傳回碼值

0 (成功) 或 (1) 失敗

結果集

資料行名稱 資料類型 描述
fulltext_catalog_id smallint 全文檢索目錄標識碼。
名字 sysname 全文檢索目錄的名稱。
PATH nvarchar(260) 從 SQL Server 2008 (10.0.x) 開始,這個子句沒有任何作用。
地位 int 目錄的全文檢索索引母體擴展狀態:

0 = 閒置

1 = 完整擴展進行中

2 = 已暫停

3 = 調整執行速度

4 = 復原中

5 = 已關閉

6 = 累加擴展進行中

7 = 正在建立索引

8 = 磁碟已滿, 已暫停

9 = 變更追蹤
NUMBER_FULLTEXT_TABLES int 與目錄相關聯的全文檢索索引數據表數目。

權限

執行許可權預設為 公用 角色。

範例

下列範例會傳回全文檢索目錄的相關信息 Cat_Desc

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

另請參閱

FULLTEXTCATALOGPROPERTY (Transact-SQL)
sp_fulltext_catalog (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)
系統預存程序 (Transact-SQL)