sp_help_fulltext_system_components (Transact-SQL)

適用対象: SQL Server Azure Synapse Analytics

登録済みのワード ブレーカー、フィルター、およびプロトコル ハンドラーの情報を返します。 sp_help_fulltext_system_components は、指定されたコンポーネントを使用するデータベースとフルテキスト カタログの識別子の一覧も返します。

Transact-SQL 構文表記規則

構文

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

引数

'all'

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

[ @component_type = ] N'component_type'

コンポーネントの種類を指定します。 @component_typesysname で、次のいずれかのオプションを指定できます。

  • wordbreaker
  • filter
  • protocol handler
  • fullpath

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

[ @param = ] N'param'

@paramsysname で、既定値は NULL です。 コンポーネントの種類に応じて、 @param は次のいずれかのオプションです。

  • ロケール識別子 (LCID)
  • プレフィックスが付いたファイル拡張子.
  • プロトコル ハンドラーの完全なコンポーネント名
  • コンポーネント DLL への完全パス

リターン コードの値

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

結果セット

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

列名 データ型 説明
componenttype sysname コンポーネントの種類。 次のいずれかのオプション:

-フィルター
- プロトコル ハンドラー
- ワードブレーカー
componentname sysname コンポーネントの名前
clsid uniqueidentifier コンポーネントのクラス識別子
fullpath nvarchar (256) コンポーネントの場所へのパス。

NULL = serveradmin 固定サーバー ロールのメンバーではない呼び出し元
version nvarchar(30) コンポーネントのバージョン
manufacturer sysname コンポーネントの製造元の名前

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

列名 データ型 説明
dbid int データベースの ID
ftcatid int フルテキスト カタログの ID

アクセス許可

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

解説

この方法は、アップグレードの準備をする際に特に重要です。 特定のデータベース内でストアド プロシージャを実行し、出力を使用して、特定のカタログがアップグレードの影響を受けるかどうかを判断します。

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 コンポーネントがシステムに手動でインストールされ、サーバー インスタンスに登録されている場合のフィルターの一覧を示します。

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\MSSQL13.MSSQLSERVER\MSSQL\Binn\nlhtml.dll';
GO