本文へ移動
Wagby11
マニュアルのグループを選ぶ

WAGBY11 MANUAL / 11

全文検索の索引を再構築する

データインポート後の索引作成と、通常運用での自動更新の違いを説明します。管理画面から再構築を開始し、状況と完了を確認する手順を紹介します。

最終更新日:

検索・全文検索の小目次へ

1. インポート後の索引作成と通常運用

データインポート後は、取り込んだデータを全文検索で探せるように、対象モデルのインデックス(索引)を作成する必要があります。既存の索引がある場合も、取込み後は再構築してデータの内容を反映します。

索引を作成した後の通常運用では、画面や標準APIによるデータの登録・更新・削除に合わせて、索引も自動的に保守されます。登録や編集のたびに、管理者が手動で再構築する必要はありません。

自動更新はバックグラウンドで進むため、登録・変更の直後は検索への反映まで時間がかかることがあります。添付ファイル本文の抽出も順次処理されます。

2. 管理画面を開く

  1. システムメニューを利用できる管理者でWeb UIにログインします。
  2. メニューの「システム」を選択し、「システム運用」を開きます。
  3. 「全文検索索引の管理」を開きます。
システム運用メニューにある全文検索索引の管理。
システム運用メニューから「全文検索索引の管理」を開きます。

全文検索を有効にしたモデルが一覧に表示されます。初期表示で現在の状況を取得し、「状況確認」を押すと最新の情報を取得します。インポート画面にも、この管理画面へのリンクがあります。

3. 再構築を開始する

  1. インポート・復元したモデルを一覧で確認します。
  2. 対象モデルの行にある「再構築開始」を押します。
  3. 受付メッセージと、そのモデルの「再構築受付済み」の表示を確認します。

次は「製品/サービス」の索引を再構築する例です。受付メッセージが表示された時点では、処理の完了を意味しません。受付済み・再構築中は、そのモデルの開始ボタンが無効になります。開始ボタンを繰り返し押さず、「状況確認」で処理の進み具合を確認してください。

製品/サービスの再構築を受け付け、開始ボタンが無効になった管理画面。
「製品/サービス」の再構築要求を受け付けた状態。

再構築はバックグラウンドで進みます。対象モデルの全文検索は完了まで一時的に利用できませんが、通常検索は利用できます。他の索引準備済みモデルの全文検索も利用できます。

4. 状況と完了を確認する

  1. 少し待ってから「状況確認」を押します。表示はボタンを押した時点の情報です。
  2. 処理中は「再構築中」と「再構築の走査件数」を確認します。
  3. 対象モデルが「検索可能」になったら、索引の再構築は完了です。開始した画面では完了メッセージも表示されます。
  4. 更新待ちがある場合は反映状況も確認し、代表的なキーワードを使って検索結果を確認します。

例では、製品/サービスの索引内レコード数が8件になっています。小さいモデルでは処理がすぐに終わり、「再構築中」を表示する前に「検索可能」へ変わることもあります。走査件数は再構築中に表示され、完了すると「—」に戻ります。

製品/サービスの索引再構築が完了し、検索可能と8件の索引を表示した管理画面。
再構築完了メッセージと、索引状態「検索可能」を確認します。

画面の項目の読み方

項目確認する内容
索引状態「再構築受付済み」「再構築中」「検索可能」などの状態を表示します。「再構築失敗」の場合は管理者がログや設定を確認します。
索引内レコード数検索用索引に登録されたレコード数です。業務データがあるのに0件の場合は、インポート後の索引作成が反映されているかを確認します。
再構築の走査件数再構築中に読み進めたレコード数です。割合や残り時間を示す値ではありません。
更新待ち登録・更新・削除などによる、索引への未反映通知数を表示します。更新失敗の件数も確認できます。
添付ファイル解析添付本文の解析待ち・失敗・完了・対象外・一部抽出の件数です。索引の再構築完了と、添付本文の解析完了を分けて確認します。

添付ファイルの解析待ちがある場合、本文が全文検索へ反映されるまで時間がかかります。解析失敗がある場合は、対応する形式か、保存先にファイルがあるか、暗号化されていないかなどを確認します。全文検索の索引が「検索可能」になっていても、すべての添付本文の解析が完了しているとは限りません。

5. 再構築が必要な場面

  • データをインポートした後。
  • バックアップから業務DBを復元した後。
  • 標準の登録・更新・削除処理を経由せず、直接SQLなどでデータを書き換えた後。

普段の画面や標準APIで登録・更新・削除している場合は、自動更新に任せます。通常の起動では、作成済みの索引を引き続き利用します。

親モデルから子モデルも全文検索する構成では、親を再構築すると、紐づく子の対象本文も読み直します。子モデル単独の全文検索にも反映する場合は、子の索引も再構築してください。

6. 参考資料

guide:全文検索
designer/docs/appschema/markdown/guide/07-screens/23-fulltext-search.md
reference:全文検索
designer/docs/appschema/markdown/reference/24-fulltext-search.md
REST API:全文検索の運用
restapi/docs/html/39_fulltext_operations.html