sp_fulltext_service (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

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

引数

[ @action = ] N'action'

変更またはリセットするプロパティ。 @actionは nvarchar(100) で、既定値はありません。 @actionプロパティ、プロパティの説明、設定できる値の一覧については、@value引数の下の表を参照してください。

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

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

[ @value = ] value

@valueはsql_variantで、既定値は NULL.

指定したプロパティの値。 @valueはsql_variantで、既定値は NULL です。 @valueが null の場合は、sp_fulltext_service現在の設定を返します。 次の表は、アクション プロパティとその説明、および設定できる値の一覧です。

Note

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

アクション データの種類 説明
クリーン_up int 旧バージョンとの互換性のためにのみサポートされています。 値は常に 0.
connect_timeout int 旧バージョンとの互換性のためにのみサポートされています。 値は常に 0.
data_timeout int 旧バージョンとの互換性のためにのみサポートされています。 値は常に 0.
load_os_resources int オペレーティング システムのワード ブレーカー、ステミング機能、フィルターを SQL Server のこのインスタンスに登録して使用するかどうかを示します。 次のいずれか:

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 フルテキスト検索に登録された言語の一覧を更新します。 言語は、インデックス作成を構成するときに、およびフルテキスト クエリで指定されます。 フィルターは、フルテキスト インデックス作成のために、varbinary、varbinary(max)、image、xml などのデータ型に格納.docxなどの対応するファイル形式からテキスト情報を抽出するために、フィルター デーモン ホストによって使用されます。

詳細については、「 登録済みのフィルターおよびワード ブレーカーの表示または変更」を参照してください。
upgrade_option int データベースを SQL Server 2005 (9.x) から新しいバージョンにアップグレードするときにフルテキスト インデックスを移行する方法を制御します。 このプロパティは、データベースのインポート、データベース バックアップの復元、ファイル バックアップの復元、またはデータベース コピー ウィザードを使用したデータベースのコピーによってアップグレードする場合に適用されます。

次のいずれか:

0 = フルテキスト カタログは、新しい拡張ワード ブレーカーを使用して再構築されます。 インデックスの再構築には時間がかかる場合があり、アップグレード後に大量の CPU とメモリが必要になる場合があります。

1 = フルテキスト カタログがリセットされます。 SQL Server 2005 (9.x) のフルテキスト カタログ ファイルは削除されますが、フルテキスト カタログのメタデータおよびフルテキスト インデックスは保持されます。 アップグレード後、すべてのフルテキスト インデックスは変更の追跡に対して無効になり、クロールは自動的に開始されません。 アップグレードの完了後、手動で完全作成を実行するまで、カタログは空のままになります。

2 = フルテキスト カタログがインポートされます。 通常、インポートは再構築よりも高速です。 たとえば、CPU を 1 つだけ使用している場合、インポートは、再構築の約 10 倍の速さで実行されます。 ただし、インポートされたフルテキスト カタログでは、新しい拡張ワード ブレーカーは使用されないため、最終的にフルテキスト カタログを再構築することもできます。

注: 再構築はマルチスレッド モードで実行できます。また、使用可能な CPU が 10 個を超える場合は、すべての CPU のリビルドを許可すると、インポートよりもリビルドの実行速度が速くなる可能性があります。

フルテキスト カタログを使用できない場合は、関連付けられているフルテキスト インデックスが再構築されます。 このオプションは SQL Server 2005 (9.x) データベースでのみ使用できます。

フルテキスト アップグレード オプションの選択については、「フルテキスト検索のアップグレード」をご覧ください。

注: SQL Server Management Studio でこのプロパティを設定するには、フルテキスト アップグレード オプション プロパティを使用します。 詳細については、「 サーバー インスタンスでのフルテキスト検索の管理と監視」を参照してください。
verify_signature int フルテキスト エンジンが署名付きバイナリのみを読み込むかどうかを示します。 既定では、信頼された署名付きバイナリのみが読み込まれます。

1 = 信頼された署名付きバイナリのみを確認して読み込む (既定値)

0 = バイナリが署名されているかどうかを確認しないでください。

リターン コードの値

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

結果セット

なし。

アクセス許可

serveradmin 固定サーバー ロールまたはシステム管理者のメンバーのみが実行sp_fulltext_serviceできます。

例

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

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

EXEC sp_fulltext_service 'update_languages';
GO

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

次の例では、フルテキスト アップグレード オプションを変更してフルテキスト カタログをリセットし、完全に削除します。 この例では、省略可能な @action と @value 引数を指定します。

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

関連するコンテンツ