Search Administration and Tuning
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

検索管理

コントロールパネル→検索には、接続、インデックス操作、フィールドマッピングという3つの管理UIがあります。「接続」では、インストールが接続されている検索エンジンが表示され、「インデックスアクション」は再インデックスのためのインターフェースであり、「フィールドマッピング」では、Liferayから検索インデックスにマッピングされたフィールドが表示されます。

検索管理パネルには、3つの管理画面があります。

つながり

検索エンジンへの接続情報が表示されます。例:

  • 検索エンジンベンダー:Elasticsearch
  • クライアントバージョン: 8.19.11
  • 有効な接続:1
  • 稼働状態:緑
  • 接続ID: _REMOTE_
  • 接続タイプ:読み取り/書き込み
  • クラスター名:LiferayElasticsearchCluster
  • ノード:1
  • ノード名:lr-es
  • Nodeバージョン: 8.19.13

インデックス操作

インデックス操作では、Liferayのデータを再インデックス化できます。

インデックス操作のユーザーインターフェースを使用して、インデックスを再構築します。

アクションリストは以下のようにグループ化されています。

  • Globalは、すべての検索インデックスとすべてのスペルチェック辞書を保有しています。
  • アカウントなどの各アプリケーションのグループには、インデックス可能なタイプごとに1つのエントリが格納されます。
  • 末尾にある検索チューニングおよびワークフローグループには、アプリケーションインデックスごとに1つのエントリが格納されます(ワークフローの場合はLiferay DXP 2026.Q4以降)。検索チューニングとワークフローインデックスの再インデックス化を参照してください。
  1. グローバルメニュー → コントロールパネル → 検索を開き、「インデックス操作」タブをクリックします。

  2. [Liferay DXP 2023.Q4+/Portal GA102+]再インデックスモードを選択します。

    再インデックスモードを選択してください。

    Liferay DXP 2023.Q4/Portal GA102+以降では、検索のダウンタイムを回避するために、再インデックスのモードを設定できます。新たに導入された同時実行モードと同期モードについては、 「インデックス再作成モード」を参照してください。

  3. [Liferay 7.4+]再インデックススコープを選択し、再インデックスするインスタンスを選択します。

    再インデックスするインスタンスを選択してください。

    Liferay 7.4以降では、再インデックス操作の範囲を特定の仮想インスタンスに限定することができます。

  4. 再インデックスしたいエントリの「再インデックス」をクリックしてください。

  5. [Liferay DXP 2023.Q4+/Portal GA102+] ダイアログで「実行」をクリックして、再インデックスを確定します。

    インデックスの再構築を行うことを確認してください。

すべてのコンテンツを再インデックス化しています

すべてのコンテンツを再インデックスすると、システムおよび企業インデックス内のすべての検索エンジンドキュメントが削除され、データベースから再作成されます。 Liferay 7.4以降では、再インデックス処理によって検索チューニングインデックス(結果ランキングと同義語セット)も再構築されます。 Liferay DXP 2026.Q4以降では、ワークフローメトリクスのインデックスも再構築され、不足しているインデックスは作成されます。

警告

再インデックスモードを使用しない場合、Commerceの機械学習(ML)インデックスやAnalytics Cloudのレコメンデーションインデックスは再構築されません。それらのデータは検索エンジンにのみ存在し、インデックスアクションには表示されません。スナップショットでバックアップしておけば、復元できます。アップグレード前にインデックスをバックアップする方法を参照してください。

検索エンジンがElasticsearchの場合、再インデックス処理中にログにupdate_mappingメッセージが出力されます。

{"type": "server", "timestamp": "2023-01-10T14:33:04,513Z", "level": "INFO", "component": "o.e.c.m.MetadataMappingService", "cluster.name": "LiferayElasticsearchCluster", "node.name": "lr-es", "message": "[liferay-20097/mc59Scl8TJeuvcDR3y2W-g] update_mapping [LiferayDocumentType]", "cluster.uuid": "QnWxrpxaSUKF2upHDNWKkQ", "node.id": "thpwCzS_TvGgfVxQ-P_l9g"

Liferay 7.4 U45+/GA45+ および Liferay DXP 7.3 U14+ では、Liferay のログにシステムインデックスと会社インデックスの再インデックスの開始と終了が記録されます。例:

2023-01-09 20:44:17.730 INFO  [liferay/background_task-2][ReindexPortalBackgroundTaskExecutor:57] Start reindexing company 0
2023-01-09 20:44:53.677 INFO  [liferay/background_task-2][ReindexPortalBackgroundTaskExecutor:76] Finished reindexing company 0
2023-01-09 20:44:53.677 INFO  [liferay/background_task-2][ReindexPortalBackgroundTaskExecutor:57] Start reindexing company 20097
2023-01-09 20:45:00.986 INFO  [liferay/background_task-2][ReindexPortalBackgroundTaskExecutor:76] Finished reindexing company 20097

以前のアップデートおよびLiferay Portal 7.3では、同様の情報を表示するには、以下のログ設定を有効にしてください。

ロガーカテゴリーレベル
com.liferay.portal.search.internal.background.task.ReindexStatusMessageSenderImplDEBUG
com.liferay.portal.search.internal.SearchEngineInitializerINFO

個々のタイプの再インデックス化

個々の型(例: com.liferay.account.model.AccountEntry )のインデックスを再構築すると、エンティティを表すインデックスドキュメントが削除され、データベースから再作成されます。 Elasticsearchのログには、update_mappingメッセージが出力されます。

{"type": "server", "timestamp": "2023-01-10T14:38:12,302Z", "level": "INFO", "component": "o.e.c.m.MetadataMappingService", "cluster.name": "LiferayElasticsearchCluster", "node.name": "lr-es", "message": "[liferay-20097/mc59Scl8TJeuvcDR3y2W-g] update_mapping [LiferayDocumentType]", "cluster.uuid": "QnWxrpxaSUKF2upHDNWKkQ", "node.id": "thpwCzS_TvGgfVxQ-P_l9g"

Liferay 7.4 U45+/GA45+ および Liferay DXP 7.3 U14+ では、Liferay のログに再インデックスの開始時刻と終了時刻が記録されます。例:

2023-01-10 14:14:00.840 INFO  [liferay/background_task-2][ReindexSingleIndexerBackgroundTaskExecutor:122] Start reindexing company 20097 for class name com.liferay.account.model.AccountEntry
2023-01-10 14:14:00.907 INFO  [liferay/background_task-2][ReindexSingleIndexerBackgroundTaskExecutor:145] Finished reindexing company 20097 for class name com.liferay.account.model.AccountEntry

検索チューニングとワークフローインデックスの再インデックス化

アクションリストの最後の2つのグループには、アプリケーションが所有するインデックスのエントリが含まれています。検索チューニンググループには、ランキングと類義語セットのエントリが表示されます。彼らは結果ランキングと類義語セットを支持している。 Liferay DXP 2026.Q4+のワークフローグループには、ワークフローメトリクスのインスタンス、ノード、プロセス、SLAインスタンス結果、SLAタスク結果、タスク、およびトランジションのエントリが表示されます。これらのインデックスは関連しているため、1つのエントリを再インデックスすると、他のエントリも再インデックスされる可能性があります。

同時実行モードでは個々のエントリのインデックスを再構築できないため、完全インデックス再構築モードまたは同期インデックス再構築モードを選択してください。次に、該当項目の「インデックスの再作成」ボタンをクリックします。

インデックス操作の「検索チューニング」グループと「ワークフロー」グループには、それぞれアプリケーションインデックスが一覧表示され、「インデックスの再作成」ボタンが表示されます。

再インデックスFinished reindexing company [companyId] for class name [reindexer class] with execution mode [mode]インデックスが完了しました」と表示されます。

Liferay DXP 2026.Q4より前のバージョンでは、インデックスアクションにワークフローメトリクスのインデックスが表示されません。代わりに、ワークフローメトリクスアプリケーションの「設定」ページからインデックスを再作成してください。ワークフローメトリクスの再インデックス化を参照してください。

スペルチェック辞書のインデックスを再構築する

コンテンツ全体を再インデックスするたびに、スペルチェック辞書も再インデックスしてください。スペルチェック辞書を再インデックスすると、各言語の Liferay 辞書ファイルの内容 (例: com/liferay/portal/search/dependencies/spellchecker/en_US.txt) がシステムおよび会社インデックス用に再インデックスされます。 Elasticsearchのログにupdate_mappingメッセージが出力されます。

{"type": "server", "timestamp": "2023-01-10T14:33:14,991Z", "level": "INFO", "component": "o.e.c.m.MetadataMappingService", "cluster.name": "LiferayElasticsearchCluster", "node.name": "lr-es", "message": "[liferay-0/9ZIx-bT6TyiekzarKELQkA] update_mapping [LiferayDocumentType]", "cluster.uuid": "QnWxrpxaSUKF2upHDNWKkQ", "node.id": "thpwCzS_TvGgfVxQ-P_l9g"  }

Liferay 7.4 U45+/GA45+ および Liferay DXP 7.3 U14+ では、Liferay のログに再インデックスの開始時刻と終了時刻が記録されます。例えば、

2023-01-10 14:16:34.170 INFO  [http-nio-8080-exec-7][BaseSpellCheckIndexWriter:278] Start indexing dictionary com/liferay/portal/search/dependencies/spellchecker/en_US.txt for company 0
2023-01-10 14:16:41.592 INFO  [http-nio-8080-exec-7][BaseSpellCheckIndexWriter:301] Finished indexing dictionary com/liferay/portal/search/dependencies/spellchecker/en_US.txt for company 0
2023-01-10 14:16:41.593 INFO  [http-nio-8080-exec-7][BaseSpellCheckIndexWriter:278] Start indexing dictionary com/liferay/portal/search/dependencies/spellchecker/es_ES.txt for company 0
2023-01-10 14:16:44.570 INFO  [http-nio-8080-exec-7][BaseSpellCheckIndexWriter:301] Finished indexing dictionary com/liferay/portal/search/dependencies/spellchecker/es_ES.txt for company 0
2023-01-10 14:16:44.571 INFO  [http-nio-8080-exec-7][BaseSpellCheckIndexWriter:278] Start indexing dictionary com/liferay/portal/search/dependencies/spellchecker/en_US.txt for company 20097
2023-01-10 14:16:49.547 INFO  [http-nio-8080-exec-7][BaseSpellCheckIndexWriter:301] Finished indexing dictionary com/liferay/portal/search/dependencies/spellchecker/en_US.txt for company 20097
2023-01-10 14:16:49.548 INFO  [http-nio-8080-exec-7][BaseSpellCheckIndexWriter:278] Start indexing dictionary com/liferay/portal/search/dependencies/spellchecker/es_ES.txt for company 20097
2023-01-10 14:16:52.235 INFO  [http-nio-8080-exec-7][BaseSpellCheckIndexWriter:301] Finished indexing dictionary com/liferay/portal/search/dependencies/spellchecker/es_ES.txt for company 20097

分野マッピング

「フィールドマッピング」タブには、システムで有効なすべてのフィールドマッピングがインデックス別に表示されます。現在、マッピングの表示、コピー、拡大縮小、およびダークテーマでの表示が可能です。

Elasticsearchクラスタ内の任意のインデックスのフィールドマッピングを調べます。