sp_help_fulltext_catalogs_cursor (Transact-SQL)
適用対象: 
SQL Server Azure SQL Database Azure SQL Managed Instance
カーソルを使用して、指定されたフルテキスト カタログの ID、名前、ルート ディレクトリ、状態、およびフルテキスト インデックス付きテーブルの数を返します。
重要
この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに、 sys.fulltext_catalogs カタログ ビューを使用してください。
構文
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 | カタログに関連付けられているフルテキスト インデックス付きテーブルの数。 |
アクセス許可
実行アクセス許可は、既定で public ロールに設定されます。
例
次の例では、フルテキスト カタログ 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