ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。
Elasticsearchコネクターの設定リファレンス
ここに記載されている構成情報は、Liferay Portal 7.2-7.4 CE および Liferay DXP 7.2-7.4 用の Elasticsearch 6 および Elasticsearch 7 コネクタの最新バージョン（バンドル版またはマーケットプレイス経由）と、すべての四半期リリースに適用されます。 必要に応じて、正確なGA/Service Pack/Fix PackおよびMarketplaceのバージョンに関する適切な情報が提供されます。
重要
- Liferay DXP 2026.Q1以降では、Elasticsearchへの接続を設定するために、ネイティブのElasticsearch 8設定エントリが使用されます。
- Liferay DXP 2026.Q1以前では、Elasticsearch 7のシステム設定エントリと対応する設定ファイルは、Elasticsearch 8への接続設定にも使用されます。
Elasticsearchへの接続は、システム設定（または対応する構成ファイル介して）のElasticsearch 6/7/8の設定エントリーで主に定義されます。 Liferay 7.3、7.4、および四半期ごとのリリースでは、 ファクトリ構成 Elasticsearch Connections を介して、Elasticsearchへの複数の接続を定義できます。 どちらのエントリも、 システム設定 または OSGi 設定ファイル を通じて設定できます。 本番環境では、設定ファイルを使用することをお勧めします。
設定ファイルとシステム設定項目
| サーバーの接続 | システム設定エントリー/コンフィグファイル |
|---|---|
| Liferay 7.2.x Elasticsearch 6.x | Elasticsearch 6com.liferay.portal.search.elasticsearch6.config.ElasticsearchConfiguration.config |
| Liferay 7.2.x Elasticsearch 7.x | Elasticsearch 7com.liferay.portal.search.elasticsearch7.config.ElasticsearchConfiguration.config |
| Liferay 7.3、7.4、四半期リリース Elasticsearch 7.x/8.x | Elasticsearch 7com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.configElasticsearch Connections (factory) com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConnectionConfiguration-[connectionId].config |
| Liferay DXP 2026.Q1+ Elasticsearch 8.19+ | Elasticsearch 8com.liferay.portal.search.elasticsearch8.configuration.ElasticsearchConfiguration.configElasticsearch接続 (ファクトリ) com.liferay.portal.search.elasticsearch8.configuration.ElasticsearchConnectionConfiguration-[connectionId].config |
Liferay 7.3、7.4、およびすべての四半期リリースでは、Elasticsearch Connections と呼ばれる追加の接続設定エントリがあります。 これを使用してElasticsearchへの接続を定義できますが、接続を1つだけ設定する場合は、メインのElasticsearch設定エントリを引き続き使用できます。 複数の接続を使用する場合は、適切な名前のファイルを使用して接続を定義します。
com.liferay.portal.search.elasticsearch8.configuration.ElasticsearchConnectionConfiguration-[connectionId].config
Elasticsearch 6にセキュリティを設定する場合は、別途Liferayの設定（およびLESのサブスクリプション）が必要です。 詳細については、 Elasticsearch のセキュリティ保護 を参照してください。
設定ファイルを [Liferay_Home]/osgi/configs にデプロイし、リスナーが設定を自動検出してデータベースに書き込みます。
構成プロパティ
重要
以下の表で 非推奨 と記載されているすべての設定は、Elasticsearch 8 の設定エントリから削除されます。
| システム設定 フィールド名 | 設定ファイルのシンタックスとデフォルト値 説明（クリックして展開） | 利用可能 |
|---|---|---|
| 一般的な接続設定 | ||
| 合計ヒット数を記録 |
この設定は非推奨となり、Track Total Hits Limit に置き換えられました。 | Liferay 7.2+ (Connector to Elasticsearch 7) |
| 合計ヒット数追跡の制限値 |
検索結果はこの値まで正確にカウントされます。 値を低く設定すると、検索パフォーマンスが向上する場合があります。 最小許容値は、最大結果ウィンドウ値です。 許容される最大値は2147483647です。 | Liferay 2025.Q4+ |
| 本番モードが有効 |
生産モードを有効にします。 Liferay 7.3では、 | Liferay 7.3、7.4、四半期ごとのリリース |
| 再インデックスが必要 インデックス名プレフィックス |
検索インデックス名の接頭辞として使用する文字列値を設定します。 初期値は通常の状態では変更しないでください。 変更する場合は、ポータルに対して reindex all 操作を実行し、Elasticsearch 管理コンソールを使用して古いインデックスを手動で削除する必要があります。 | Liferay 7.2+ |
| 再インデックスが必要 7.3.x→会社およびシステムインデックスレプリカの数 7.2.x→インデックスレプリカ数 |
Liferay の各会社およびシステム インデックスのレプリカ数を設定します。 設定されていない場合は、レプリカを使用しません。 この値を変更するには、すべてのコンテンツの再インデックス作成が必要です。 デフォルト値は、コネクターに同梱されている "index-settings-defaults.json "というファイルに定義されています。 | Liferay 7.2+ |
| 再インデックスが必要 7.3.x→会社およびシステムインデックスシャードの数 7.2.x→インデックスシャード数 |
Liferay の会社およびシステム インデックスを作成する際に使用するシャードの数を設定します。 設定されていない場合は、1つのシャードが使用されます。 この値を変更するには、すべてのコンテンツの再インデックス作成が必要です。 デフォルト値は、コネクターに同梱されている "index-settings-defaults.json "というファイルに定義されています。 | Liferay 7.2+ |
| 結果の最大件数 |
検索クエリから返される結果の最大数を設定します。 | Liferay 7.4 U72/GA72+ |
| 例外のみロギングする |
true の場合、Elasticsearch からの例外のみをログに記録し、再スローしないブール値の設定です。 | Liferay 7.2+ |
| コンフリクト時の再試行 |
ドキュメントを取得してから更新するまでの間にドキュメントが更新されたためにバージョン競合が発生した場合に試行する再試行回数を整数値で設定します（詳細については、 および を参照してください）。 | Liferay 7.1では使用されなくなりました。 |
| 最大接続数 |
HTTP接続の最大数を設定します。 | Liferay 7.4 U67/GA67+ |
| ルートごとの最大接続数 |
ルートごとの最大 HTTP 接続数を設定します。 | Liferay 7.4 U67/GA67+ |
| セキュリティ設定 | ||
| 認証が有効 |
ユーザー名とパスワードを使用して Elasticsearch への認証を有効または無効にします。 | Liferay 7.3、7.4、四半期ごとのリリース |
| ユーザー名 |
[認証有効]がチェックされている場合、Elasticsearchへの認証に使用するユーザー名を設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| パスワード |
[認証有効]がチェックされている場合、Elasticsearchへの認証用のパスワードを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| HTTP SSLが有効 |
TLS/SSL を有効または無効にします。 | Liferay 7.3、7.4、四半期ごとのリリース |
| トラストストアの種類 |
HTTP SSL が有効になっている場合は、トラストストアのタイプを設定します。 お使いの JDK バージョン でサポートされている フォーマットを選択してください (例: | Liferay 7.3、7.4、四半期ごとのリリース |
| トラストストアのパス |
HTTP SSL が有効になっている場合は、トラストストア ファイルへのパスを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| トラストストアのパスワード |
HTTP SSL が有効になっている場合は、トラストストアのパスワードを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| Elasticsearch接続設定 | ||
| 有効 |
必要に応じて接続をアクティブ化または非アクティブ化します。 Elasticsearch 7の設定のRemote Cluster Connection IDの設定で選択されている場合は、接続を無効にしないでください。 | Liferay 7.3、7.4、四半期ごとのリリース |
| 接続ID |
接続に一意のIDを設定します。 アクティブな場合、この接続はElasticsearch 7構成のRemote Cluster Connection IDプロパティで選択できるようになります。 | Liferay 7.3、7.4、四半期ごとのリリース |
| レストクライアント設定 | ||
| ネットワークホストアドレス |
Liferay からクライアント要求を送信するリモート HTTP ホストを設定します。 これは、RESTクライアント接続を構成するため、Liferay 7.3、7.4、および四半期ごとのリリースで必須です。 リクエストは、RESTクライアントによって ラウンドロビンノード選択戦略を使用して分散されます。。 | Liferay 7.3、7.4、四半期ごとのリリース |
| Restクライアントのロガーレベル |
DXP 7.3 U4+、DXP 7.4 GA1+、および Portal 7.4 GA5+ 以降では非推奨です。 | Liferay 7.3、7.4、四半期ごとのリリース |
| トランスポートクライアント設定（埋め込み & リモート） | ||
| 動作モード |
操作モードは 2 つから選択できます: EMBEDDED または REMOTE。 REMOTEに設定すると、リモートのスタンドアロンElasticsearchクラスタに接続します。 EMBEDDEDに設定すると、Liferayを内部のElasticsearchインスタンスで起動します。 EMBEDDEDの動作モードは、実運用環境ではサポートされておらず、「開発モード」の機能と考えられます。 | Liferay 7.2. Liferay 7.3で非推奨となり、 本番モードが有効に置き換えられました。 |
| クラスター名 |
クラスター名は、Liferay 7.2 のトランスポート クライアントでのみ必要です。 統合するクラスタを宣言するためのString値を設定します。 Liferay 7.3、7.4、および四半期ごとのリリースでは、接続はRESTクライアントを介して管理されるため、このプロパティは開発モード時に組み込みクラスタに名前を付けるためにのみ使用されます。 | Liferay 7.2- 7.3、7.4、および四半期ごとのリリースでは、これは開発モードに適用されます |
| トランスポート アドレス |
接続するリモート Elasticsearch ノードのアドレスの文字列値を設定します。 この値は、操作モードがリモートに設定されている場合に必要です（詳細については、 および を参照してください）。 任意の数のノードを指定することができます。 | Liferay 7.2 |
| クライアント・トランスポート・スニフ |
このブール値を true に設定すると、クラスタ スニッフィングが有効になり、クラスタ内の利用可能なデータ ノードが動的に検出されます (詳細については、 を参照してください)。 | Liferay 7.2 |
| クライアントのトランスポートは、クラスター名を無視します。 |
接続されたノードのクラスタ名の検証を無視するには、このブール値を true に設定します (詳細については、 および を参照してください)。 | Liferay 7.2 |
| クライアント・トランスポート・Ping タイムアウト |
クライアントノードがノードからのping応答を待つ時間（秒単位）を設定します。 設定されていない場合は、デフォルトのElasticsearch | Liferay 7.2 |
| クライアント・トランスポート・ノード のサンプル間隔 |
この文字列値を設定すると、クライアントノードがリストされ接続されているノードをサンプリング/pingする頻度を指示します（詳細については、 の を参照してください）。 | Liferay 7.2 |
| 他の設定 | ||
| リモートクラスター接続ID |
リモート Elasticsearch クラスターへの接続の接続 ID を選択します。 利用可能な接続は、「Elasticsearch Connections System Settings」エントリで定義されます。 この値が設定されていない場合は、Elasticsearch 7エントリの接続設定がリモートクラスタの接続に使用されます。 | Liferay 7.3、7.4、四半期リリースで LES クロスクラスタレプリケーション を使用する場合 |
| 開発モード設定（埋め込み & サイドカー） | ||
| 追加設定 |
組み込み Elasticsearch のカスタム設定の文字列値を YML 形式で設定します。 参照: Liferay Elasticsearch Connector の高度な設定。 | Liferay 7.2+ |
| Bootstrap Mlock All |
ブーリアン値で、 | Liferay 7.2+ |
| 埋め込みHttpポート |
この設定は EMBEDDED モードにのみ適用されます。 実行モードがEMBEDDEDモードに設定されている時に作成される、埋め込みのElasticsearchノードのHTTPポートを設定します。 | Liferay 7.2. Liferay 7.3.xでは非推奨となり、 Sidecar HTTP Portに置き換えられました。 |
| Httpが有効 |
これがチェックされている場合、HTTP レイヤーが有効になります。 チェックされていない場合、RESTリクエストに直接対応することを意図していないノードでは、HTTPレイヤーが無効になります。 | Liferay 7.1.xで非推奨となりました。 |
| Http CORS 許可オリジン |
HTTP CORS が有効になっているときに許可する文字列オリジンを設定します (詳細については、 および を参照してください)。 | Liferay 7.2+ |
| Http CORS 設定 |
HTTP CORS のカスタム設定の文字列値を YML 形式で設定します ( | Liferay 7.2+ |
| Http CORSが有効 |
クロスオリジン リソース共有を無効にするには、このブール値を false に設定します。 | Liferay 7.2+ |
| ネットワーク ホスト |
この文字列値を設定すると、ノードはこのホスト名またはIPアドレスにバインドし、このホストをクラスタ内の他のノードに公開（アドバタイズ）します。 これは、バインドホストとパブリッシュホストを同時に設定するショートカットです（詳細については、 および を参照してください）。 | Liferay 7.2+ |
| ネットワークバインドホスト |
ノードが着信リクエストをリッスンできるようにバインドするネットワークインターフェイスの文字列値を設定します（詳細については、 および を参照してください）。 | Liferay 7.2+ |
| ネットワーク公開ホスト |
ノードがクラスタ内の他のノードにアドバタイズする単一のインターフェイスの文字列値を設定します。これにより、それらのノードが接続できるようになります（詳細については、 および を参照してください）。 | Liferay 7.2+ |
| トランスポート Tcpポート |
ノード間の通信にバインドするポートの文字列値を設定します。 単一の値または範囲を受け入れます（詳細については、 および を参照してください）。 | Liferay 7.2+ |
| Zenディスカバリー・ユニキャスト・ホストポート |
discovery.zen.ping.unicast.hosts の値を作成する際に使用するポート範囲の文字列値を設定します。 | Liferay DXP 7.2 |
| サイドカー設定 | ||
| ノード名 |
組み込みElasticsearchサーバーのノードに名前を付けます。 リモートのElasticsearchサーバーのノード名は、そのElasticsearch.ymlの | Liferay 7.3、7.4、四半期ごとのリリース |
| Sidecarデバッグ |
サイドカー プロセスのデバッグ モードを有効にするには、これを true に設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| Sidecarデバッグ設定 |
サイドカー プロセスのデバッグに使用する JVM オプションを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| Sidecarのハートビート監視間隔 |
サイドカー プロセスの健全性を検出するために使用されるハートビート間隔をミリ秒単位で設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| Sidecarホーム |
サイドカー プロセスを開始するために使用されるサイドカー ベース フォルダーのパスを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| Sidecar HTTPポート |
この設定は、サイドカー Elasticsearch を備えた Liferay 7.3 にのみ適用されます。 サイドカーのElasticsearchノードのHTTPポートレンジを設定します。 AUTOに設定すると、9201～9300番台のポートを自動的に検出します。 設定されていない場合は、Embedded HTTP portの値（デフォルトでは、 | Liferay 7.3、7.4、四半期ごとのリリース |
| Sidecar JVMオプション |
サイドカー プロセスで使用される JVM オプションを設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| Sidecarのシャットダウンタイムアウト |
サイドカー プロセスが強制的にシャットダウンされるまでの待機時間をミリ秒単位で設定します。 | Liferay 7.3、7.4、四半期ごとのリリース |
| 詳細設定 | ||
| 再インデックスが必要 追加のインデックス構成 |
Liferay インデックスのカスタム設定の文字列値を JSON または YML 形式で設定します (詳細については、Elasticsearch Create Index API を参照してください)。 参照: Liferay Elasticsearch Connector の高度な設定。 | Liferay 7.2+ |
| 再インデックスが必要 追加の型マッピング |
セットのカスタムマッピングのための文字列値 | Liferay 7.2+ |
| 再インデックスが必要 型マッピングをオーバーライド |
ここでの設定は、Liferay のデフォルトの型マッピングを上書きします。 これは高度な機能であり、厳密に必要な場合にのみ使用する必要があります。 この値を設定すると、Liferay のソース コード内のデフォルトのマッピング (たとえば、 | Liferay 7.2+ |
| プロキシホスト |
クライアント接続のプロキシホストを設定します。 | Liferay DXP 7.3 FP1 /SP1およびLiferay Portal GA7 |
| プロキシポート |
クライアント接続のプロキシポートを設定します。 | Liferay DXP 7.3 FP1 /SP1およびLiferay Portal GA7 |
| プロキシユーザー名 |
プロキシ接続のプロキシユーザー名を設定します。 | Liferay DXP 7.3 FP1 /SP1およびLiferay Portal GA7 |
| プロキシパスワード |
プロキシに接続するためのパスワードを設定します。 | Liferay DXP 7.3 FP1 /SP1およびLiferay Portal GA7 |