sp_help_fulltext_columns_cursor (Transact-SQL)
適用対象: SQL サーバー
カーソルを使用して、フルテキスト インデックス作成用に指定された列を返します。
重要
この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに、 sys.fulltext_index_columns カタログ ビューを使用してください。
構文
sp_help_fulltext_columns_cursor
[ @cursor_return = ] cursor_return OUTPUT
[ , [ @table_name = ] N'table_name' ]
[ , [ @column_name = ] N'column_name' ]
[ ; ]
引数
[ @cursor_return = ] cursor_return OUTPUT
@cursor_return は、 int 型の OUTPUT パラメーターです。結果のカーソルは、読み取り専用のスクロール可能な動的カーソルです。
[ @table_name = ] N'table_name'
フルテキスト インデックス情報が要求される 1 部構成または 2 部構成のテーブル名。 @table_name は nvarchar(517) で、既定値は NULL
です。
@table_nameを省略すると、フルテキスト インデックス付きテーブルごとにフルテキスト インデックス列の情報が取得されます。
[ @column_name = ] N'column_name'
フルテキスト インデックス メタデータが必要な列の名前。 @column_name は sysname で、既定値は NULL
です。 @column_nameを省略した場合、またはNULL
されている場合は、@table_nameのすべてのフルテキスト インデックス付き列に対してフルテキスト列情報が返されます。
@table_nameも省略されるか、NULL
されている場合は、データベース内のすべてのテーブルのすべてのフルテキスト インデックス列に対してフルテキスト インデックス列情報が返されます。
リターン コードの値
0
(成功) または 1
(失敗)。
結果セット
列名 | データ型 | 説明 |
---|---|---|
TABLE_OWNER |
sysname | テーブル所有者 所有者は、テーブルを作成したデータベース ユーザーの名前です。 |
TABLE_ID |
int | テーブルの ID。 |
TABLE_NAME |
sysname | テーブル名。 |
FULLTEXT_COLUMN_NAME |
sysname | インデックス作成用に指定されたフルテキスト インデックス付きテーブル内の列。 |
FULLTEXT_COLID |
int | フルテキスト インデックスが作成された列の列 ID。 |
FULLTEXT_BLOBTP_COLNAME |
sysname | フルテキスト インデックスが作成されたテーブル内の列で、フルテキスト インデックス列のドキュメントの種類を指定する列。 この値は、フルテキスト インデックス付き列が varbinary(max) または image 列である場合にのみ適用されます。 |
FULLTEXT_BLOBTP_COLID |
int | ドキュメントの種類の列の列 ID。 この値は、フルテキスト インデックス付き列が varbinary(max) または image 列である場合にのみ適用されます。 |
FULLTEXT_LANGUAGE |
sysname | 列のフルテキスト検索に使用される言語。 |
アクセス許可
実行アクセス許可は、 public ロールのメンバーに既定で設定されます。
例
次の例では、データベース内のすべてのテーブルでフルテキスト インデックス作成用に指定された列に関する情報を返します。
USE AdventureWorks2022;
GO
DECLARE @mycursor CURSOR;
EXEC sp_help_fulltext_columns_cursor @mycursor OUTPUT
FETCH NEXT FROM @mycursor;
WHILE (@@FETCH_STATUS <> -1)
BEGIN
FETCH NEXT FROM @mycursor;
END;
CLOSE @mycursor;
DEALLOCATE @mycursor;
GO