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

Elasticsearchコネクターの設定リファレンス

ここでの設定情報は、Liferay Portal 7.2-7.4 CE および Liferay DXP 7.2-7.4、およびすべての四半期リリース用の Elasticsearch 6 および Elasticsearch 7 コネクタの最新バージョン（バンドルまたはマーケットプレイス経由）に適用されます。必要に応じて、正確なGA/Service Pack/Fix PackおよびMarketplaceのバージョンに関する適切な情報が提供されます。

重要

Elasticsearch 7 システム設定エントリと対応する構成ファイルは、Elasticsearch 8 への接続を構成するためにも使用されます。

Elasticsearch への接続は、主にシステム設定の Elasticsearch 6/7 構成エントリ (または対応する構成ファイル経由) で定義されます。 Liferay 7.3、7.4、および四半期リリースでは、ファクトリー構成 Elasticsearch 接続を通じて、Elasticsearch への複数の接続を定義できます。両方のエントリは、システム設定または OSGi 構成ファイルを通じて構成できます。本番環境では、設定ファイルを使用することをお勧めします。

設定ファイルとシステム設定項目

サーバーの接続	システム設定エントリー/コンフィグファイル
Liferay 7.2.x Elasticsearch 6.x	Elasticsearch 6 `com.liferay.portal.search.elasticsearch6.config.ElasticsearchConfiguration.config`
Liferay 7.2.x Elasticsearch 7.x	Elasticsearch 7 `com.liferay.portal.search.elasticsearch7.config.ElasticsearchConfiguration.config`
Liferay 7.3、7.4、四半期リリース Elasticsearch 7.x/8.x	Elasticsearch 7 `com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConfiguration.config` Elasticsearch Connections (factory) `com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConnectionConfiguration-[connectionId].config`

Liferay 7.3以降では、Elasticsearch接続という接続設定項目が追加されています。これを使用してElasticsearchへの任意の接続を定義することができますが、1つの接続のみを設定する場合は、メインのElasticsearch 7設定エントリを使用することができます。複数の接続を使用する場合は、それに応じた名前を付けたファイルで接続を定義します。

com.liferay.portal.search.elasticsearch7.configuration.ElasticsearchConnectionConfiguration-[connectionId].config

Elasticsearch 6にセキュリティを設定する場合は、別途Liferayの設定（およびLESのサブスクリプション）が必要です。詳細については、 Elasticsearch のセキュリティ保護を参照してください。

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

構成プロパティ

システム設定フィールド名	設定ファイルのシンタックスとデフォルト値説明（クリックして展開）	利用可能
	一般的な接続設定
合計ヒット数を記録	`trackTotalHits=B"true"` 有効にすると、検索の結果が 10,000 件を超える場合にヒット数が正確にカウントされます。この機能を有効にしておくと、検索結果の件数が多い場合にパフォーマンスに影響を与えることがあります。	Liferay 7.2+ (Connector to Elasticsearch 7)
本番モードが有効	`productionModeEnabled=B"false"` プロダクションモードを有効にします。 Liferay 7.3では、 `productionModeEnabled` が、非推奨の設定である `operationMode`を置き換えています。これをチェックすると、プロダクションモードが有効になり、Operation Modeの設定は無視されます。本番モードを有効にするには、リモートのスタンドアロンElasticsearchクラスタに接続する必要があります。無効のままだと動作モードの設定が使用されます。	Liferay 7.3、7.4、四半期リリース
再インデックスが必要ですインデックス名のプレフィックス	`indexNamePrefix="liferay-"` 検索インデックス名のプレフィックスとして使用する文字列値を設定します。初期値は通常の状態では変更しないでください。変更する場合は、ポータルのすべてのインデックスを再作成操作も実行し、Elasticsearch 管理コンソールを使用して古いインデックスを手動で削除する必要があります。	Liferay 7.2+
再インデックスが必要です 7.3.x→会社とシステムのインデックスレプリカの数 7.2.x→インデックスレプリカの数	`indexNumberOfReplicas="0～すべて"` Liferay の会社とシステムインデックスごとにレプリカの数を設定します。設定されていない場合は、レプリカを使用しません。この値を変更するには、すべてのコンテンツの再インデックスが必要です。デフォルト値は、コネクターに同梱されている "index-settings-defaults.json "というファイルに定義されています。	Liferay 7.2+
再インデックスが必要です 7.3.x→会社とシステムのインデックスシャードの数 7.2.x→インデックスシャードの数	`indexNumberOfShards="1"` Liferay の会社およびシステムインデックスの作成時に使用するシャードの数を設定します。設定されていない場合は、1つのシャードが使用されます。この値を変更するには、すべてのコンテンツの再インデックスが必要です。デフォルト値は、コネクターに同梱されている "index-settings-defaults.json "というファイルに定義されています。	Liferay 7.2+
結果の最大件数	`indexMaxResultWindow="10000"` 検索クエリから返される結果の最大数を設定します。 `index.max_result_window` を追加のインデックス構成で同時に設定している間は、このプロパティを使用しないでください。	ライフレイ 7.4 U72/GA72+
例外のみロギングする	`logExceptionsOnly=B"true"` true の場合、Elasticsearch からの例外のみをログに記録し、例外を再スローしないブール設定。	Liferay 7.2+
コンフリクト時の再試行	`retryOnConflict="5"` ドキュメントを取得してから更新するまでの間にドキュメントが更新されたためにバージョンの競合が発生した場合に試行する再試行回数の整数値を設定します (詳細については、こちらを参照してください)。	Liferay 7.1では使用されなくなりました。
最大接続数	`maxConnections="75"` HTTP接続の最大数を設定します。	ライフレイ 7.4 U67/GA67+
ルートごとの最大接続数	`maxConnectionsPerRoute="75"` ルートあたりの HTTP 接続の最大数を設定します。	ライフレイ 7.4 U67/GA67+
	セキュリティ設定
認証が有効	`authenticationEnabled=B"false"` ユーザー名とパスワードによる Elasticsearch への認証を有効または無効にします。	Liferay 7.3、7.4、四半期リリース
ユーザー名	`username="elastic"` 「認証の有効化」がチェックされている場合、Elasticsearch への認証に使用するユーザー名を設定します。	Liferay 7.3、7.4、四半期リリース
パスワード	`password=""` 「認証の有効化」がチェックされている場合は、Elasticsearch への認証に使用するパスワードを設定します。	Liferay 7.3、7.4、四半期リリース
HTTP SSLが有効	`httpSSLEnabled="false"` TLS/SSLを有効または無効にします。	Liferay 7.3、7.4、四半期リリース
トラストストアの種類	`truststoreType="pkcs12"` HTTP SSL が有効な場合は、トラストストアのタイプを設定します。お使いの JDK バージョンでサポートされている形式を選択します (例: `jks` または `pkcs12`)。	Liferay 7.3、7.4、四半期リリース
トラストストアのパス	`truststorePath="/path/to/localhost.p12"` HTTP SSL Enabled がチェックされている場合は、トラストストアファイルへのパスを設定します。	Liferay 7.3、7.4、四半期リリース
トラストストアのパスワード	`truststorePassword=""` HTTP SSL Enabled がチェックされている場合は、トラストストアのパスワードを設定します。	Liferay 7.3、7.4、四半期リリース
	Elasticsearch接続設定
有効	`active=B"false"` 必要に応じて接続をアクティブ化または非アクティブ化します。 Elasticsearch 7の設定のRemote Cluster Connection IDの設定で選択されている場合は、接続を無効にしないでください。	Liferay 7.3、7.4、四半期リリース
接続ID	`connectionId=""` 接続に一意の ID を設定します。アクティブな場合、この接続はElasticsearch 7構成のRemote Cluster Connection IDプロパティで選択できるようになります。	Liferay 7.3、7.4、四半期リリース
	レストクライアント設定
ネットワークホストアドレス	`networkHostAddresses="[http://localhost:9200]"` Liferay からクライアント要求を送信するリモート HTTP ホストを設定します。これは、REST クライアント接続を構成するため、Liferay 7.3、7.4、および四半期リリースで必須です。リクエストは、ラウンドロビンノード選択戦略を使用して REST クライアントによって分散されます。。	Liferay 7.3、7.4、四半期リリース
Restクライアントのロガーレベル	`RESTClientLoggerLevel="エラー"` DXP 7.3 U4+、DXP 7.4 GA1+、および Portal 7.4 GA5+ では廃止されました。	Liferay 7.3、7.4、四半期リリース
	トランスポートクライアント設定（埋め込み & リモート）
動作モード	`operationMode="EMBEDDED"` 選択できる操作モードは、EMBEDDED または REMOTE の 2 つです。 REMOTEに設定すると、リモートのスタンドアロンElasticsearchクラスタに接続します。 EMBEDDEDに設定すると、Liferayを内部のElasticsearchインスタンスで起動します。 EMBEDDEDの動作モードは、実運用環境ではサポートされておらず、「開発モード」の機能と考えられます。	Liferay 7.2. Liferay 7.3で非推奨となり、本番モードが有効に置き換えられました。
クラスター名	`clusterName="LiferayElasticsearchCluster"` クラスター名は、Liferay 7.2 のトランスポートクライアントにのみ必要です。統合するクラスタを宣言するためのString値を設定します。 Liferay 7.3、7.4、および四半期リリースでは、接続はRESTクライアントを通じて管理され、このプロパティは開発モードのときに埋め込みクラスターの名前を付けるためにのみ使用されます。	Liferay 7.2- 7.3、7.4、四半期リリースでは開発モードに適用されます
トランスポートアドレス	`transportAddresses=["localhost:9300"]` 接続するリモート Elasticsearch ノードのアドレスの文字列値を設定します。この値は、操作モードがリモートに設定されている場合に必要です (詳細については、ここを参照してください)。任意の数のノードを指定することができます。	Liferay 7.2
クライアント・トランスポート・スニフ	`clientTransportSniff=B"true"` このブール値を true に設定すると、クラスタースニッフィングが有効になり、クラスター内の使用可能なデータノードが動的に検出されます (詳細については、こちらを参照してください)。	Liferay 7.2
クライアントのトランスポートは、クラスター名を無視します。	`clientTransportIgnoreClusterName=B"false"` このブール値を true に設定すると、接続されたノードのクラスター名検証が無視されます (詳細については、こちらを参照してください)。	Liferay 7.2
クライアント・トランスポート・Ping タイムアウト	`clientTransportPingTimeout=""` クライアントノードがノードからのping応答を待機する時間（秒単位）を設定します。設定されていない場合は、デフォルトのElasticsearch `client.transport.ping_timeout` が使用されます。	Liferay 7.2
クライアント・トランスポート・ノードのサンプル間隔	`clientTransportNodesSamplerInterval=""` この文字列値を設定して、リストされ接続されているノードをサンプリング/pingする頻度をクライアントノードに指示します (詳細については、こちらを参照してください)。	Liferay DXP 7.2
	他の設定
リモートクラスター接続ID	`remoteClusterConnectionId=` リモート Elasticsearch クラスターへの接続用の接続 ID を選択します。利用可能な接続は、「Elasticsearch Connections System Settings」エントリで定義されます。この値が設定されていない場合は、Elasticsearch 7エントリの接続設定がリモートクラスタの接続に使用されます。	Liferay 7.3、7.4、四半期リリースで LES クロスクラスタレプリケーションを使用する場合
	開発モード設定（埋め込み & サイドカー）
追加設定	`additionalConfigurations=""` 埋め込み Elasticsearch のカスタム設定の文字列値を YML 形式で設定します。参照: Liferay Elasticsearch コネクタの詳細設定。	Liferay 7.2+
Bootstrap Mlock All	`bootstrapMlockAll="false"` ブール値設定。 `true`に設定すると、プロセスアドレス空間を RAM にロックして、Elasticsearch メモリがスワップアウトされるのを防止します (詳細については、こちらを参照)。	Liferay 7.2+
埋め込みHttpポート	`embeddedHttpPort="9201"` この構成は EMBEDDED モードにのみ適用されます。実行モードがEMBEDDEDモードに設定されている時に作成される、埋め込みのElasticsearchノードのHTTPポートを設定します。	Liferay 7.2. Liferay 7.3.xでは非推奨となり、 Sidecar HTTP Portに置き換えられました。
Httpが有効	`httpEnabled=B"true"` これにチェックを入れると、HTTP レイヤーが有効になります。チェックされていない場合、RESTリクエストに直接対応することを意図していないノードでは、HTTPレイヤーが無効になります。	Liferay 7.1.xで非推奨となりました。
Http CORS 許可オリジン	`httpCORSAllowOrigin="/https?:\\/\\/localhost(:[0-9]+)?/"` HTTP CORS が有効な場合に許可する文字列オリジンを設定します (詳細については、こちらを参照してください)。	Liferay 7.2+
Http CORS 設定	`httpCORSConfigurations=` HTTP CORS のカスタム設定の文字列値を YML 形式 (`elasticsearch.yml`) で設定します (詳細については、こちらを参照してください)。	Liferay 7.2+
Http CORSが有効	`httpCORSEnabled=B"true"` クロスオリジンリソース共有を無効にするには、このブール値を false に設定します。 `false`に設定すると、他のオリジンのブラウザはElasticsearchへのリクエストを行うことができません。 Elasticsearch Head などの Web フロントエンドツールは接続できない可能性があります (詳細については、こちらを参照してください)。	Liferay 7.2+
ネットワークホスト	`networkHost=""` この文字列値を設定して、ノードにこのホスト名または IP アドレスにバインドし、このホストをクラスター内の他のノードに公開 (アドバタイズ) するように指示します。これは、バインドホストと公開ホストを同時に設定するショートカットです (詳細については、こちらを参照してください)。	Liferay 7.2+
ネットワークバインドホスト	`networkBindHost=""` ノードがバインドして着信要求をリッスンできるネットワークインターフェイスの文字列値を設定します (詳細については、こちらを参照してください)。	Liferay 7.2+
ネットワーク公開ホスト	`networkPublishHost=""` ノードがクラスター内の他のノードにアドバタイズする単一のインターフェースの文字列値を設定します。これにより、それらのノードがそのインターフェースに接続できるようになります (詳細については、こちらを参照してください)。	Liferay 7.2+
トランスポート Tcpポート	`transportTcpPort=""` ノード間の通信にバインドするポートの文字列値を設定します。単一の値または範囲を受け入れます (詳細については、ここを参照してください)。	Liferay 7.2+
Zenディスカバリー・ユニキャスト・ホストポート	`discoveryZenPingUnicastHostsPort="9300-9400"` `discovery.zen.ping.unicast.hosts`の値を構築するときに使用するポートの範囲の文字列値を設定します。さまざまなポート上の複数の Elasticsearch ノードは、同じコンピューターでゴシップルーターとして動作できます (詳細については、こちらを参照してください)。 7.3で廃止、直接の置き換えなし.	Liferay 7.2
	サイドカー設定
ノード名	`nodeName=` 埋め込み Elasticsearch サーバーのノードに名前を付けます。リモートのElasticsearchサーバーのノード名は、そのElasticsearch.ymlので設定されます。	Liferay 7.3、7.4、四半期リリース
Sidecarデバッグ	`sidecarDebug=B"false"` サイドカープロセスのデバッグモードを有効にするには、これを true に設定します。	Liferay 7.3、7.4、四半期リリース
Sidecarデバッグ設定	`sidecarDebugSettings="-agentlib:jdwp=transport=dt_socket,address=8001,server=y,suspend=y,quiet=y"` サイドカープロセスのデバッグに使用する JVM オプションを設定します。	Liferay 7.3、7.4、四半期リリース
Sidecarのハートビート監視間隔	`sidecarHeartbeatInterval="10000"` サイドカープロセスの健全性を検出するために使用されるハートビート間隔をミリ秒単位で設定します。	Liferay 7.3、7.4、四半期リリース
Sidecarホーム	`sidecarHome="elasticsearch7"` サイドカープロセスを開始するために使用するサイドカーベースフォルダーのパスを設定します。	Liferay 7.3、7.4、四半期リリース
Sidecar HTTPポート	`sidecarHttpPort="9200"` この設定は、サイドカー Elasticsearch を備えた Liferay 7.3 にのみ適用されます。サイドカーのElasticsearchノードのHTTPポートレンジを設定します。 AUTOに設定すると、9201～9300番台のポートを自動的に検出します。設定されていない場合は、Embedded HTTP portの値（デフォルトでは、`9201` ）が使用されます。	Liferay 7.3、7.4、四半期リリース
Sidecar JVMオプション	`sidecarJVMOptions="-Xms1g\\|-Xmx1g\\|-XX:+AlwaysPreTouch"` サイドカープロセスで使用される JVM オプションを設定します。	Liferay 7.3、7.4、四半期リリース
Sidecarのシャットダウンタイムアウト	`sidecarShutdownTimeout="10000"` サイドカープロセスが強制的にシャットダウンされるまでの待機時間をミリ秒単位で設定します。	Liferay 7.3、7.4、四半期リリース
	詳細設定
再インデックスが必要です追加のインデックス構成	`additionalIndexConfigurations=""` Liferayインデックスのカスタム設定の文字列値をJSONまたはYML形式で設定します（詳細については、Elasticsearch Create Index APIを参照してください）。参照: Liferay Elasticsearch コネクタの詳細設定。	Liferay 7.2+
再インデックスが必要です追加の型マッピング	`additionalTypeMappings=""` `LiferayDocumentType`のカスタムマッピングの文字列値をJSON形式で設定します（詳細については、Elasticsearch Put Mapping APIを参照してください）。参照： Liferay Elasticsearchコネクタの詳細設定。	Liferay 7.2+
再インデックスが必要です型マッピングを上書きします	`overrideTypeMappings=""` ここでの設定は、Liferay のデフォルトのタイプマッピングを上書きします。これは高度な機能であり、厳密に必要な場合にのみ使用する必要があります。この値を設定すると、Liferay のソースコード内のデフォルトのマッピング（たとえば、 `index-mappings.json`）は完全に無視されるため、変更するセグメントだけでなく、マッピング定義全体をこのプロパティに含めます。	Liferay 7.2+
プロキシホスト	`proxyHost=""` クライアント接続のプロキシホストを設定します。	Liferay DXP 7.3 FP1 /SP1およびLiferay Portal GA7
プロキシポート	`proxyPort="0"` クライアント接続のプロキシポートを設定します。	Liferay DXP 7.3 FP1 /SP1およびLiferay Portal GA7
プロキシユーザー名	`proxyUserName=""` プロキシ接続のプロキシユーザー名を設定します。	Liferay DXP 7.3 FP1 /SP1およびLiferay Portal GA7
プロキシパスワード	`proxyPassword=""` プロキシに接続するためのパスワードを設定します。	Liferay DXP 7.3 FP1 /SP1およびLiferay Portal GA7