sp_help_fulltext_tables_cursor (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance Analytics Platform System (PDW)
カーソルを使用して、フルテキスト インデックス作成用として登録されたテーブルの一覧を返します。
重要
この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに、新しい sys.fulltext_indexes カタログ ビューを使用してください。 詳細については、「 sys.fulltext_indexes (Transact-SQL)」を参照してください。
構文
sp_help_fulltext_tables_cursor
[ @cursor_return = ] cursor_return OUTPUT
[ , [ @fulltext_catalog_name = ] N'fulltext_catalog_name' ]
[ , [ @table_name = ] N'table_name' ]
[ ; ]
引数
[ @cursor_return = ] cursor_return OUTPUT
cursor 型の出力変数。 カーソルは、読み取り専用でスクロール可能な動的カーソルです。
[ @fulltext_catalog_name = ] N'fulltext_catalog_name'
フルテキスト カタログの名前です。 @fulltext_catalog_name は sysname で、既定値は NULL です。
@fulltext_catalog_nameを省略するか、
NULLすると、データベースに関連付けられているフルテキスト インデックス付きテーブルがすべて返されます。@fulltext_catalog_nameが指定されていても、@table_nameが省略されるか、
NULLされている場合、このカタログに関連付けられているすべてのフルテキスト インデックステーブルのフルテキスト インデックス情報が取得されます。@fulltext_catalog_nameと@table_nameの両方を指定すると、@table_nameが@fulltext_catalog_nameに関連付けられている場合は行が返されます。それ以外の場合は、エラーが発生します。
[ @table_name = ] N'table_name'
フルテキスト メタデータが要求される 1 部構成または 2 部構成のテーブル名。 @table_name は nvarchar(517) で、既定値は NULL です。 @table_nameのみを指定した場合は、@table_nameに関連する行のみが返されます。
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
| 列名 | データ型 | 説明 |
|---|---|---|
TABLE_OWNER |
sysname | テーブル所有者 これは、テーブルを作成したデータベース ユーザーの名前です。 |
TABLE_NAME |
sysname | テーブル名。 |
FULLTEXT_KEY_INDEX_NAME |
sysname | 一意キー列として指定された列に UNIQUE 制約を課すインデックス。 |
FULLTEXT_KEY_COLID |
int | FULLTEXT_KEY_INDEX_NAMEによって識別される一意のインデックスの列 ID。 |
FULLTEXT_INDEX_ACTIVE |
int | このテーブルでフルテキスト インデックス作成のマークが付いている列がクエリに適しているかどうか。0 = 非アクティブ1 = アクティブ |
FULLTEXT_CATALOG_NAME |
sysname | フルテキスト インデックス データが存在するフルテキスト カタログ。 |
アクセス許可
実行アクセス許可は、 public ロールのメンバーに既定で設定されます。
例
次の例では、フルテキスト カタログ Cat_Desc に関連付けられた、フルテキスト インデックスが作成されているテーブルの名前を返します。
USE AdventureWorks2022;
GO
DECLARE @mycursor CURSOR;
EXEC sp_help_fulltext_tables_cursor @mycursor OUTPUT, 'Cat_Desc';
FETCH NEXT FROM @mycursor;
WHILE (@@FETCH_STATUS <> -1)
BEGIN
FETCH NEXT FROM @mycursor;
END;
CLOSE @mycursor;
DEALLOCATE @mycursor;
GO