sp_help_fulltext_tables_cursor (Transact-SQL)
カーソルを使用して、フルテキスト インデックス作成用として登録されたテーブルの一覧を返します。
.gif "重要な注意事項") 重要 |
|---|
この機能は、将来のバージョンの Microsoft SQL Server では削除される予定です。 新しい開発作業では、この機能の使用を避け、現在この機能を使用しているアプリケーションは修正するようにしてください。代わりに、新しい sys.fulltext_indexes カタログ ビューを使用してください。詳細については、「sys.fulltext_indexes (Transact-SQL)」を参照してください。 |
.gif "トピック リンク アイコン")
構文
sp_help_fulltext_tables_cursor [ @cursor_return = ] @cursor_variable OUTPUT
[ , [ @fulltext_catalog_name = ] 'fulltext_catalog_name' ]
[ , [ @table_name = ] 'table_name' ]
引数
[ @cursor_return= ] @cursor\_variable OUTPUT
cursor 型の出力変数を指定します。カーソルは読み取り専用で、スクロール可能な動的カーソルです。[ @fulltext_catalog_name= ] '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 に関連付けられている場合は 1 行が返され、それ以外の場合はエラーが返されます。[ @table_name=] '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_NAME で指定された一意なインデックスの列 ID。 |
FULLTEXT_INDEX_ACTIVE |
int |
このテーブルでフルテキスト インデックス作成のマークが付いている列がクエリに適しているかどうか。 0 = 非アクティブ 1 = アクティブ |
FULLTEXT_CATALOG_NAME |
sysname |
フルテキスト インデックス データが存在するフルテキスト カタログ。 |
権限
実行権限は、既定では public ロールのメンバに与えられています。
例
次の例では、フルテキスト カタログ Cat_Desc に関連付けられた、フルテキスト インデックスが作成されているテーブルの名前を返します。
USE AdventureWorks;
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