次の方法で共有


sp_help_fulltext_catalogs_cursor (Transact-SQL)

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance

カーソルを使用して、指定されたフルテキスト カタログの ID、名前、ルート ディレクトリ、状態、およびフルテキスト インデックス付きテーブルの数を返します。

重要

この機能は、 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_namesysname で、既定値は 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