OpenSearchコネクタ構成リファレンス

サブスクリプションが必要です Liferay DXP 2025.Q1+

Liferay の osgi/configs フォルダにデプロイされた設定ファイルを使用して、Liferay と OpenSearch の接続を設定します。 対応する システム設定 エントリ OpenSearch および OpenSearch 接続 を使用して構成を確認および調整することもできます。

| システム設定エントリ | 設定ファイル | 説明 | | :— | :— | : — | | OpenSearch | com.liferay.portal.search.opensearch2.configuration.OpenSearchConfiguration.config | アクティブな OpenSearch 接続の接続 ID を設定し、Liferay のインデックスとマッピングの動作を構成します。 | | OpenSearch 接続 | com.liferay.portal.search.opensearch2.configuration.OpenSearchConnectionConfiguration-[connectionId].config | Liferay と OpenSearch を正常に接続するためのすべての固有のプロパティを使用して、OpenSearch への個別の接続を設定します。 |

OpenSearchへの接続を複数定義し、使用する接続を選択できます。 ファクトリ構成ファイルを使用する場合は、接続ごとに個別の OpenSearchConnectionConfiguration ファイルを用意してください。 ファイル名と connectionId プロパティに同じ ID を使用できます。 これらのファイルは、 REMOTE1 および REMOTE2 接続を定義します。

com.liferay.portal.search.opensearch2.configuration.OpenSearchConnectionConfiguration-REMOTE1.config
com.liferay.portal.search.opensearch2.configuration.OpenSearchConnectionConfiguration-REMOTE2.config

設定ファイルを [Liferay_Home]/osgi/configsにデプロイすると、リスナーが設定を自動的に検出し、データベースに書き込みます。

OpenSearch接続設定

システム設定 フィールド名	設定ファイルのシンタックスとデフォルト値 説明（クリックして展開）
有効	active=B"false" 必要に応じて接続をアクティブ化または非アクティブ化します。 OpenSearch構成の「リモートクラスタ接続ID」設定で選択されている場合は、その接続を無効化しないでください。
接続ID	connectionId="" 接続に一意のIDを設定します。 有効になっている場合、この接続はOpenSearch構成の「リモートクラスタ接続ID」プロパティで選択できるようになります。
ネットワークホストアドレス	networkHostAddresses="[http://localhost:9200]" 接続するリモート HTTP ホストを設定します。
認証が有効	authenticationEnabled=B"false" ユーザー名とパスワードを使用して OpenSearch への認証を有効または無効にします。
ユーザー名	username="opensearch" 認証が有効になっている場合、OpenSearch に認証するためのユーザー名を設定します。
パスワード	password="" [認証有効]がチェックされている場合、OpenSearchへの認証用のパスワードを設定します。
HTTP SSLが有効	httpSSLEnabled=B"false" TLS/SSL を有効または無効にします。
最大接続数	maxConnections="75" HTTP接続の最大数を設定します。
ルートごとの最大接続数	maxConnectionsPerRoute="75" ルートごとの最大 HTTP 接続数を設定します。
圧縮が有効です	compressionEnabled=B"true" REST クライアントが gzip を使用してリクエストとレスポンスを圧縮することを有効または無効にします。
トラストストアの種類	truststoreType="pkcs12" HTTP SSL が有効になっている場合は、トラストストアのタイプを設定します。 お使いの JDK バージョン でサポートされている フォーマットを選択してください (例: jks または pkcs12)。
トラストストアのパス	truststorePath="/path/to/localhost.p12" HTTP SSL が有効になっている場合は、トラストストア ファイルへのパスを設定します。
トラストストアのパスワード	truststorePassword="" HTTP SSL が有効になっている場合は、トラストストアのパスワードを設定します。
プロキシホスト	proxyHost="" クライアント接続のプロキシホストを設定します。
プロキシポート	proxyPort="0" クライアント接続のプロキシポートを設定します。
プロキシユーザー名	proxyUserName="" プロキシ接続のプロキシユーザー名を設定します。
プロキシパスワード	proxyPassword="" プロキシに接続するためのパスワードを設定します。

OpenSearchの設定

システム設定 フィールド名	設定ファイルのシンタックスとデフォルト値 説明（クリックして展開）
リモートクラスター接続ID	remoteClusterConnectionId= リモートの OpenSearch クラスターへの接続の接続 ID を選択します。 利用可能な接続は、OpenSearch接続システム設定のエントリで定義されています。 この値が設定されていない場合、リモートクラスタ接続にはOpenSearchエントリ内の接続構成が使用されます。
再インデックスが必要 インデックス名プレフィックス	indexNamePrefix="liferay-" 検索インデックス名の接頭辞として使用する文字列値を設定します。 初期値は通常の状態では変更しないでください。 変更する場合は、 reindex all 操作を実行してから、古いインデックスを手動で削除する必要があります。
再インデックスが必要 会社およびシステムインデックスのレプリカ数	indexNumberOfReplicas="0-すべて" Liferay の各会社およびシステム インデックスのレプリカ数を設定します。 設定されていない場合は、レプリカを使用しません。 この値を変更するには、すべてのコンテンツの再インデックス作成が必要です。 デフォルト値は、コネクタに同梱されている index-settings-defaults.json というファイルで定義されています。
再インデックスが必要 会社およびシステムインデックスシャードの数	indexNumberOfShards="1" Liferay の会社およびシステム インデックスを作成する際に使用するシャードの数を設定します。 設定されていない場合は、1つのシャードが使用されます。 この値を変更するには、すべてのコンテンツの再インデックス作成が必要です。 デフォルト値は、コネクタに同梱されている index-settings-defaults.json というファイルで定義されています。
結果の最大件数	indexMaxResultWindow="10000" 検索クエリから返される結果の最大数を設定します。 ポータルプロパティ index.search.limit を同じ値に設定します。 デフォルト検索結果権限フィルタ構成の searchQueryResultWindowLimit はこの値を超えてはなりません。 追加インデックス構成で index.max_result_window を同時に設定している場合は、このプロパティを使用しないでください。
再インデックスが必要 追加のインデックス構成	additionalIndexConfigurations="" Liferay インデックスのカスタム設定の文字列値を JSON または YML 形式で設定します。
再インデックスが必要 追加の型マッピング	additionalTypeMappings="" LiferayDocumentType のカスタムマッピングの文字列値を JSON 形式で設定します。
再インデックスが必要 型マッピングをオーバーライド	overrideTypeMappings="" ここでの設定は、Liferay のデフォルトの型マッピングを上書きします。 これは高度な機能であり、厳密に必要な場合にのみ使用する必要があります。 この値を設定すると、Liferay のソース コード内のデフォルトのマッピング (たとえば、 index-mappings.json) は完全に無視されるため、このプロパティには変更するセグメントだけでなく、マッピング定義全体を含める必要があります。
例外のみロギングする	logExceptionsOnly=B"true" true の場合、OpenSearch からの例外のみをログに記録し、例外を再スローしないブール値の設定です。
合計ヒット数を記録	trackTotalHits=B"true" この設定は非推奨となり、Track Total Hits Limit に置き換えられました。
合計ヒット数追跡の制限値	trackTotalHitsLimit="2147483647" 検索結果はこの値まで正確にカウントされます。 値を低く設定すると、検索パフォーマンスが向上する場合があります。 最小許容値は、最大結果ウィンドウ値です。 許容される最大値は2147483647です。

関連トピック

• Elasticsearch
• 検索エンジンのインストールとアップグレード