共用方式為

sp_help_fulltext_catalogs_cursor （Transact-SQL）

  • 發行項

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體

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

重要

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

Transact-SQL 語法慣例

語法

sp_help_fulltext_catalogs_cursor
    [ @cursor_return = ] cursor_return OUTPUT
    [ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
[ ; ]

引數

[ @cursor_return = ] cursor_return OUTPUT

@cursor_return是 int 類型的 OUTPUT 參數。數據指標是只讀、可捲動的動態數據指標。

[ @fulltext_catalog_name = ] N'fulltext_catalog_name'

全文檢索目錄的名稱。 @fulltext_catalog_name為 sysname，預設值為 NULL。 如果省略此參數或 為 NULL，則會傳回與目前資料庫相關聯之所有全文檢索目錄的相關信息。

傳回碼值

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

結果集

資料行名稱 資料類型 描述
fulltext_catalog_id smallint 全文檢索目錄標識碼。
NAME sysname 全文檢索目錄的名稱。
PATH nvarchar(260) 這個子句沒有作用。
STATUS 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

相關內容