FULLTEXTCATALOGPROPERTY (Transact-SQL)
更新 : 2006 年 7 月 17 日
フルテキスト カタログ プロパティについての情報を返します。
.gif "トピック リンク アイコン")
構文
FULLTEXTCATALOGPROPERTY ('catalog_name' ,'property')
引数
- catalog_name
フルテキスト カタログの名前を含む式を指定します。
property
フルテキスト カタログのプロパティ名を含む式を指定します。次の表は、プロパティと、返される情報についての説明の一覧です。プロパティ 説明 AccentSensitivity
アクセントの区別の設定。
0 = アクセントを区別しない
1 = アクセントを区別する
IndexSize
フルテキスト インデックスのサイズ (MB 単位)。
ItemCount
現在フルテキスト カタログ内にあるフルテキスト インデックス項目の数。
LogSize
旧バージョンとの互換性のためにのみサポートされています。常に 0 を返します。
Microsoft Search サービスのフルテキスト カタログに関連付けられたエラー ログの結合セットのサイズ (バイト単位)。
MergeStatus
マスタ マージの実行状況。
0 = マスタ マージが実行されていない
1 = マスタ マージが実行中
PopulateCompletionAge
01/01/1990 00:00:00 から、最後のフルテキスト インデックス作成が完了した時刻までの時間 (秒単位)。
フル クロールまたは増分クロールの場合のみ更新されます。更新するデータがなかった場合は、0 が返されます。
PopulateStatus
0 = アイドル状態
1 = カタログ全体を作成中
2 = 一時停止
3 = 絞込み
4 = 復旧 5 = シャットダウン
6 = 増分作成中
7 = インデックス作成
8 = ディスク容量不足、一時停止
9 = 変更の追跡
UniqueKeyCount
フルテキスト カタログ内にある一意のキーの数。
戻り値の型
int
例外
エラーが発生した場合、または呼び出し元にオブジェクトの表示権限がない場合は、NULL が返されます。
SQL Server 2005 では、そのユーザーが所有しているか、または権限を与えられている、セキュリティ保護可能なアイテムのメタデータのみを表示できます。つまり、オブジェクトに対する権限がユーザーに与えられていない場合、メタデータを生成する組み込み関数 (FULLTEXTCATALOGPROPERTY など) が NULL を返す可能性があります。詳細については、「メタデータ表示の構成」および「メタデータ表示のトラブルシューティング」を参照してください。
解説
アプリケーションがタイト ループで待ち状態にならないよう注意してください。この状態では、PopulateStatus プロパティを確認するとアイドル状態になっており、またカタログ作成が終了している場合があります。この場合、データベースとフルテキスト検索のプロセスに CPU サイクルの割り当てがなくなり、タイムアウトが発生します。通常は、PopulateStatus プロパティに対応するテーブル レベルのプロパティを確認する方が便利です。OBJECTPROPERTYEX システム関数の TableFullTextPopulateStatus がこれにあたります。OBJECTPROPERTYEX で、このプロパティとその他の新しいフルテキスト プロパティを使用すると、フルテキスト インデックス作成テーブルに関するより詳細な情報を取得できます。詳細については、「OBJECTPROPERTYEX (Transact-SQL)」を参照してください。
例
次の例では、Cat_Desc という名前のフルテキスト カタログにあるフルテキスト インデックス項目の個数を返します。
USE AdventureWorks;
GO
SELECT fulltextcatalogproperty('Cat_Desc', 'ItemCount');
GO
参照
関連項目
FULLTEXTSERVICEPROPERTY (Transact-SQL)
メタデータ関数 (Transact-SQL)
sp_help_fulltext_catalogs (Transact-SQL)
ヘルプおよび情報
変更履歴
| リリース | 履歴 |
|---|---|
2006 年 7 月 17 日 |
|