sp_fulltext_service (Transact-SQL)

2025-07-23

Applies to:SQL Server

SQL Server のフルテキスト検索のサーバープロパティを変更します。

Caution

upgrade_option アクションは、SQL Server 2022 (16.x) 以降のバージョンでは完全にはサポートされていません。詳細については、この記事で後述する「 SQL Server 2022 以降のバージョンとの互換性」セクションを参照してください。

Transact-SQL 構文表記規則

Syntax

sp_fulltext_service
    [ [ @action = ] N'action' ]
    [ , [ @value = ] value ]
[ ; ]

Arguments

[ @action = ] N'action'

変更またはリセットするプロパティ。 @action is nvarchar(100), with no default. For a list of @action properties, their descriptions, and the values that can be set, see the table under the @value argument.

この引数は、次のプロパティを返します。

データ型
現在の実行中の値
最小値または最大値
非推奨の状態 (該当する場合)。

[ @value = ] value

@value is sql_variant, with a default of NULL.

指定したプロパティの値。 @value is sql_variant, with a default value of NULL. If @value is null, sp_fulltext_service returns the current setting. 次の表は、アクションプロパティとその説明、および設定できる値の一覧です。

Note

SQL Server の今後のリリースでは、 clean_up、 connect_timeout、 data_timeout、 resource_usageのアクションが削除される予定です。新しい開発作業ではこれらのアクションを使用しないようにし、現在使用しているアプリケーションを変更することを計画します。

Action	Data type	Description
`clean_up`	int	旧バージョンとの互換性のためにのみサポートされています。値は常に `0`。
`connect_timeout`	int	旧バージョンとの互換性のためにのみサポートされています。値は常に `0`。
`data_timeout`	int	旧バージョンとの互換性のためにのみサポートされています。値は常に `0`。
`load_os_resources`	int	オペレーティングシステムのワードブレーカー、ステミング機能、フィルターを SQL Server のこのインスタンスに登録して使用するかどうかを示します。 One of: `0` = SQL Server のこのインスタンスに固有のフィルターとワードブレーカーのみを使用します。 `1` = オペレーティングシステムフィルターとワードブレーカーを読み込みます。オペレーティングシステムに行われた更新によって予期しない動作が起こるのを防ぐため、既定ではこのプロパティは無効になっています。オペレーティングシステムリソースの使用を有効にすると、インスタンス固有のリソースがインストールされていない Microsoft Indexing Service に登録されている言語とドキュメントの種類のリソースにアクセスできます。オペレーティングシステムリソースの読み込みを有効にする場合は、オペレーティングシステムリソースが信頼できる署名付きバイナリであることを確認します。それ以外の場合は、 `verify_signature` が `1`に設定されている場合は読み込まれません。
`master_merge_dop`	int	マスターマージプロセスで使用するスレッドの数を指定します。この値は、使用可能な CPU または CPU コアの数を超えないようにしてください。この引数を指定しない場合、サービスは使用する `4`の数が少ないか、使用可能な CPU または CPU コアの数が少なくなります。
`pause_indexing`	int	フルテキストインデックス作成を現在実行中の場合は一時停止するか、現在一時停止している場合は再開するかを指定します。 `0` = サーバーインスタンスのフルテキストインデックス作成アクティビティを再開します。 `1` = サーバーインスタンスのフルテキストインデックス作成アクティビティを一時停止します。
`resource_usage`	int	SQL Server 2008 (10.0.x) 以降のバージョンでは機能せず、無視されます。
`update_languages`	`NULL`	フルテキスト検索に登録された言語の一覧を更新します。言語は、インデックス作成を構成するときに、およびフルテキストクエリで指定されます。 Filters are used by the filter daemon host to extract textual information from corresponding file formats such as `.docx` stored in data types, such as varbinary, varbinary(max), image, or xml, for full-text indexing. 詳細については、「登録されたフィルターとワードブレーカーの表示または変更を参照してください。
`upgrade_option`	int	データベースを SQL Server 2005 (9.x) から新しいバージョンにアップグレードするときにフルテキストインデックスを移行する方法を制御します。このプロパティは、データベースのインポート、データベースバックアップの復元、ファイルバックアップの復元、またはデータベースコピーウィザードを使用したデータベースのコピーによってアップグレードする場合に適用されます。 One of: - `0` = フルテキストカタログは、新しい拡張ワードブレーカーを使用して再構築されます。インデックスの再構築には時間がかかる場合があり、アップグレード後に大量の CPU とメモリが必要になる場合があります。 - `1` = フルテキストカタログがリセットされます。 SQL Server 2005 (9.x) のフルテキストカタログファイルは削除されますが、フルテキストカタログのメタデータおよびフルテキストインデックスは保持されます。アップグレード後、すべてのフルテキストインデックスは変更の追跡に対して無効になり、クロールは自動的に開始されません。アップグレードの完了後、手動で完全作成を実行するまで、カタログは空のままになります。 - `2` = フルテキストカタログがインポートされます。通常、インポートは再構築よりも高速です。たとえば、CPU を 1 つだけ使用している場合、インポートは、再構築の約 10 倍の速さで実行されます。ただし、インポートされたフルテキストカタログでは、新しい強化されたワードブレーカーは使用されないため、代わりにフルテキストカタログを再構築することもできます。 SQL Server 2022 (16.x) 以降のバージョンで削除され、エラーが発生します。 Note: Rebuild can run in multi-threaded mode, and if more than 10 CPUs are available, rebuild might run faster than import if you allow rebuild to use all of the CPUs. フルテキストカタログを使用できない場合は、関連付けられているフルテキストインデックスが再構築されます。このオプションは、SQL Server 2005 (9.x) データベースでのみ使用できます。フルテキストアップグレードオプションの選択については、「フルテキスト検索のアップグレード」をご覧ください。 Note: To set this property in SQL Server Management Studio, use the Full-Text Upgrade Option property. 詳細については、「サーバーインスタンスでのフルテキスト検索の管理と監視」を参照してください。
`verify_signature` ¹	int	フルテキストエンジンが署名付きバイナリのみを読み込むかどうかを示します。既定では、信頼された署名付きバイナリのみが読み込まれます。 `1` = 信頼された署名付きバイナリのみが読み込まれる (既定) ことを確認します。 `0` = バイナリが署名されているかどうかを確認しないでください。

¹ When verify_signature is 1, the Full-Text Engine only checks the cached Certificate Revocation List (CRL) before loading binaries. You should periodically refresh your local CRL cache with certutil, when using third party binaries.

リターンコードの値

0 (成功) または 1 (失敗)。

Result set

None.

SQL Server 2022 以降のバージョンとの互換性

upgrade_option アクション (@action = 'upgrade_option', @value = 2 で指定) のインポート機能は、SQL Server 2022 (16.x) 以降のバージョンで削除されます。以前のバージョンの SQL Server からフルテキストインデックスをインポートする必要がある場合は、SQL Server 2019 (15.x) 以前のバージョンを使用してインポートし、SQL Server 2022 (16.x) にアップグレードできます。

Permissions

Only members of the serveradmin fixed server role or the system administrator can execute sp_fulltext_service.

Examples

A. 登録されている言語の一覧を更新する

次の例では、フルテキスト検索に登録された言語の一覧を更新します。

EXECUTE sp_fulltext_service 'update_languages';
GO

B. フルテキストカタログをリセットするようにフルテキストアップグレードオプションを変更する

次の例では、フルテキストアップグレードオプションを変更してフルテキストカタログをリセットし、完全に削除します。 This example specifies the optional @action and @value arguments.

EXECUTE sp_fulltext_service
    @action = 'upgrade_option',
    @value = 1;
GO

次の方法で共有