次の方法で共有


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)」を参照してください。

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_namesysname で、既定値は 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_namenvarchar(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