次の方法で共有

  • [アーティクル]

sp_help_fulltext_system_components (Transact-SQL)

登録済みの単語区切り、フィルタ、プロトコル ハンドラの情報を返します。また、指定したコンポーネントで使用された、データベースやフルテキスト カタログの識別子の一覧も返します。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

sp_help_fulltext_system_components 
         { 'all'| [ @component_type = ] 'component_type' }
    , [ @param = ] 'param'

引数

  • 'all'
    すべてのフルテキスト コンポーネントについての情報を返します。

  • [ @component_type= ] component_type
    コンポーネントの種類を指定します。component_type は次のいずれかになります。

    • wordbreaker

    • filter

    • protocol handler

    • fullpath

    完全なパスを指定する場合は、さらに param に DLL コンポーネントへの完全なパスを指定する必要があります。これを指定しないとエラー メッセージが返されます。

    注意注意

    フルテキスト検索コンポーネントの詳細については、「フルテキスト検索のアーキテクチャ」および「フルテキスト言語コンポーネントの構成」を参照してください。

  • [ @param= ] param
    コンポーネントの種類に応じて、ロケール識別子 (LCID)、"." プレフィックス付きのファイル拡張子、プロトコル ハンドラの完全なコンポーネント名、または DLL コンポーネントへのフル パスのいずれかを指定します。

リターン コードの値

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

結果セット

システム コンポーネントについて、次の結果セットが返されます。

列名

データ型

説明

componenttype

sysname

コンポーネントの種類。次のいずれかです。

  • filter

  • protocol handler

  • wordbreaker

componentname

sysname

コンポーネント名。

clsid

uniqueidentifier

コンポーネントのクラス ID。

fullpath

nvarchar(256)

コンポーネントの場所へのパス。

NULL = 呼び出し元は serveradmin 固定サーバー ロールのメンバではありません。

version

nvarchar(30)

コンポーネントのバージョン。

manufacturer

sysname

コンポーネントの製造元の名前。

component_type を使用するフルテキスト カタログが 1 つ以上存在する場合のみ、次の結果セットが返されます。

列名

データ型

説明

dbid

int

データベースの ID。

ftcatid

int

フルテキスト カタログの ID。

権限

ロール public のメンバシップが必要です。ただし、ユーザーが表示できるのは、VIEW DEFINITION 権限が与えられているフルテキスト カタログに関する情報のみです。fullpath 列内の値を表示できるのは、固定サーバー ロール serveradmin のメンバのみです。

説明

アップグレードの準備をする場合、このメソッドは特に重要です。特定のデータベース内でこのストアド プロシージャを実行し、その結果を使用して、特定のカタログがアップグレードの影響を受けているかどうかを判断します。

例

A. フルテキスト システム コンポーネントをすべて一覧表示する

次の例は、サーバー インスタンスに登録されているフルテキスト システム コンポーネントをすべて一覧表示します。

EXEC sp_help_fulltext_system_components 'all';
GO

B. ワード ブレーカを一覧表示する

次の例では、サービス インスタンスに登録されたワード ブレーカをすべて一覧表示します。

EXEC sp_help_fulltext_system_components 'wordbreaker';
GO

C. 特定のワード ブレーカが登録されているかどうかを確認する

次の例では、トルコ語 (LCID = 1055) がシステムにインストールされ、サービス インスタンスに登録されている場合のトルコ語のワード ブレーカを一覧表示します。この例で、パラメータ名 @component_type と @param を指定します。

EXEC sp_help_fulltext_system_components @component_type = 'wordbreaker', @param = 1055;
GO

既定では、このワード ブレーカはインストールされていないので、結果セットは空になります。

D. 特定のフィルタが登録されているかどうかを確認する

次の例では、.xdoc コンポーネントのフィルタがシステムに手動でインストールされ、サーバー インスタンスに登録されている場合の、.xdoc コンポーネントのフィルタを一覧表示します。

EXEC sp_help_fulltext_system_components 'filter', '.xdoc';
GO

既定では、このフィルタはインストールされていないので、結果セットは空になります。

E. 特定の .dll ファイルを一覧表示する

次の例では、既定でインストールされている特定の .ddl ファイル nlhtml.dll を一覧表示します。

EXEC sp_help_fulltext_system_components 'fullpath', 
   'C:\Program Files\Microsoft SQL Server\MSSQL10.MSSQLSERVER\MSSQL\Binn\nlhtml.dll';
GO

変更履歴

変更内容

構文を変更しました。

「例」を拡張しました。