Elasticsearch:Elasticsearch クラスターにアクセスするためのクライアントの使用に関する FAQ

Alibaba Cloud Elasticsearch は、オープンソースの Elasticsearch が提供する RESTful API をサポートし、専用の管理 API を提供します。

• Alibaba Cloud Elasticsearch は、オープンソースの Elasticsearch が提供する RESTful API と完全に互換性があります。 RESTful API を使用して、クラスター内のデータを管理できます。たとえば、ドキュメントの追加、ドキュメントの削除、ドキュメントの変更、データの検索、エイリアスの設定などを行うことができます。詳細については、「Restful API」をご参照ください。

• Alibaba Cloud Elasticsearch は専用の管理 API を提供します。この API を呼び出して、Alibaba Cloud Elasticsearch コンソールで実行できる操作を実装できます。たとえば、クラスターの作成や、クラスターの IP アドレスホワイトリストの設定などを行うことができます。詳細については、「機能別の操作リスト」をご参照ください。

このエラーメッセージは、Transport Client 5.5 または 5.6 が使用されているために返されます。 Alibaba Cloud Elasticsearch クラスターにアクセスするには、Transport Client 5.3.3 を使用することをお勧めします。 Transport Client を使用してアクセスできるのは、Alibaba Cloud Elasticsearch V5.5 または V5.6 クラスターのみです。 Transport Client を使用する場合、client.transport.sniff パラメーターを false に設定します。詳細については、「Transport Client (5.x)」をご参照ください。

次の表に、この問題の考えられる原因と関連する解決策を示します。

はい。 Java API を使用して、ポート 9200 経由で Elasticsearch クラスターにアクセスできます。 Alibaba Cloud Elasticsearch では、オープンソースの Elasticsearch でサポートされているすべての Java API を使用して、ポート 9200 経由ですべてのバージョンの Alibaba Cloud Elasticsearch クラスターにアクセスできます。 Alibaba Cloud Elasticsearch V5.X クラスターにアクセスする場合は、Transport Client 5.3.3 を使用してポート 9300 経由でクラスターにアクセスすることもできます。 Alibaba Cloud Elasticsearch V6.0 以降のクラスターにアクセスする場合、ポート 9300 は潜在的なセキュリティリスクがあるため使用できず、ポート 9200 のみ使用可能です。 Alibaba Cloud Elasticsearch では、カスタムポート経由でクラスターにアクセスすることはできません。

問題を解決するには、次のチェックを実行できます。

• Elasticsearch クラスターのログと監視データを表示して、クラスターで例外が発生しているかどうかを確認します。

  クラスターの状態が異常、ノードの切断などの問題がクラスターで発生している場合は、最初に問題を解決します。詳細については、「メトリクスと例外処理の推奨事項」をご参照ください。

• クライアントにネットワークインターセプトポリシーが設定されているかどうかを確認します。

  ユーザー側、Elasticsearch サービス側、およびサーバーロードバランサー (SLB) サービス側からパケットをキャプチャするようにシステムを有効にして、ネットワークの問題をトラブルシューティングできます。いずれの側でもネットワークの問題が発生していない場合は、クライアントにネットワークインターセプトポリシーが設定されているかどうかを確認する必要があります。

• HTTP keep-alive に基づいて確立された TCP 接続がタイムアウトしたかどうかを確認します。

  HTTP keep-alive により、単一の TCP 接続でサーバーとクライアント間でできるだけ多くのパケットを転送できます。サーバーとクライアント間でパケットが転送されるたびに、HTTP keep-alive に基づいて確立された TCP 接続の期間が更新されます。特定の期間中にサーバーとクライアント間でパケットが転送されない場合、TCP 接続はタイムアウトします。この場合、HTTP keep-alive は TCP 接続を解放して閉じます。

  説明

  TCP keep-alive は、TCP 接続の状態を検出するために使用されるキープアライブメカニズムです。理論的には、TCP 接続が確立された後にサーバーとクライアントで例外が発生しない場合、TCP 接続は閉じられない限り永続的に存在します。 HTTP keep-alive により、単一の TCP 接続でサーバーとクライアント間でできるだけ多くのパケットを転送できます。特定の期間中にサーバーとクライアント間でパケットが転送されない場合、HTTP keep-alive は TCP 接続を解放して閉じます。

  HTTP keep-alive に基づいて確立された TCP 接続がタイムアウトした場合は、接続タイムアウト期間を延長できます。たとえば、クライアントの ConnectTimeout パラメーターの値を 10000 に、SocketTimeout パラメーターの値を 30000 に変更できます。

Alibaba Cloud Elasticsearch クラスターにアクセスするために使用されるクライアントは、オープンソースの Elasticsearch クラスターにアクセスするために使用されるクライアントと同じ機能をサポートします。また、2 つのクライアントの機能の使用方法も同じです。次の SQL クエリメソッドがサポートされています。

• SQL REST API、SQL Translate API、SQL JDBC ドライバー などの SQL クエリメソッド。サポートされている SQL クエリメソッドの詳細については、「SQL Client Applications」をご参照ください。 V6.3 以降の Elasticsearch クラスターは、X-Pack SQL をサポートしています。

• X-Pack SQL クエリ。 Elastic が提供する x-pack-sql プラグインを使用できます。詳細については、「sql-search-api」をご参照ください。

• オープンソースプラグイン elasticsearch-sql などのサードパーティ製 SQL プラグイン。プラグインの詳細については、「elasticsearch-sql」をご参照ください。