OpenSearch:Java SDK (クエリ/プッシュ)

Java SDK は、データ処理と検索のための API 操作をカプセル化します。他の機能を使用するには、管理およびコントロール SDK を使用する必要があります。

<dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>6.4.0</version>
</dependency>

• SDK バージョン 3.1.3 は、2.1.x バージョンとは大きく異なります。2.1.x シリーズのバージョンは、Standard Edition アプリケーションへのアクセスをサポートしていません。

• SDK バージョン 3.1.3 以降は、Premium Edition と Standard Edition の両方のアプリケーションをサポートしています。

• 複数アプリケーションのクエリをサポートします。

• バージョン 3.1.3 では、scroll メソッドはソートをサポートしていません。

V6.4.0 (2026-01-29)

ドキュメントをプッシュする際の upsert 操作のサポートが追加されました。

V6.3.0 (2025-12-12)

マルチパス検索のサポートが追加されました。

V6.2.1 (2025-07-22)

org.json の依存関係をバージョン 20250517 にアップグレードしました。

V6.2.0 (2025-02-21)

チャットクエリのサポートを追加しました。

V6.1.0 (2024-08-16)

Bearer Token アクセスのサポートを追加しました。

V6.0.1 (2024-01-18)

• 応答ステータスコードが 4xx または 5xx の範囲にある場合に発生する可能性のある「Socket Closed」エラーを修正しました。

• OpenSearchClient をビルドする際に HttpClientManager インスタンスを渡すことができるようになりました。

V6.0.0 (2023-11-20)

• Credential Provider SDK のサポートを追加しました。

• リクエスト後に元の HttpResponse オブジェクトを取得できるようになりました。

• Server-Sent Events (SSE) のサポートを追加しました。

V5.1.0 (2023-09-15)

GET 以外のメソッドで、クエリ文字列を介してパラメーターと認証を渡すサポートを追加しました。

V5.0.0 (2022-12-02)

各 OpenSearchClient インスタンスは、1 つを共有する代わりに、独自の HttpClientManager インスタンスを持つようになりました。

JSONArray でドキュメントを渡すことをサポートするために、オーバーロードされた DocumentClient.push メソッドを追加しました。

com.aliyun.opensearch.tracer.ClientTracer リクエスト監視インターフェイスを追加しました。

V3 管理およびコントロール API リクエストを非推奨にしました。

• FinalDistinct 句のサポートを追加しました。

• カスタムクエリ句のサポートを追加しました。

• セキュリティトークンサービス (STS) の一時トークンのサポートを追加しました。

• Rank.secondRankType 検索パラメーターを追加しました。有効な値は EXPRESSION と CAVA_SCRIPT です。

• 検索候補機能に userId と reSearch パラメーターを追加しました。reSearch パラメーターは HOMONYM に設定できます。

• 検索候補機能に SuggestParams クラスと execute メソッドを追加しました。

• 検索候補の数のパラメーターが無効だったバグを修正しました。

• 検索候補機能の reSearch パラメーターの値を HOMONY から HOMONYM に修正しました。

• STS 一時トークンのサポートを追加しました。

• Rank.secondRankType 検索パラメーターを追加しました。有効な値は EXPRESSION と CAVA_SCRIPT です。

• 検索候補機能に userId と reSearch パラメーターを追加しました。reSearch パラメーターは HOMONY に設定できます。

• 検索候補機能に SuggestParams クラスと execute メソッドを追加しました。

• データ収集 2.0 のサポートを追加しました。

• HTTPS のサポートを追加しました。

• A/B テストのパラメーター渡しに関する問題を修正しました。

• データ収集 2.0

• HTTPS のサポートを追加しました。

• A/B テストのサポートを追加しました。

• 行動データ収集のサポートを追加しました。

• Maven リポジトリのアドレス

  <dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>3.3.0</version>
  </dependency>

• 新機能

  A/B テストのサポートを追加しました。

  行動データ収集のサポートを追加しました。

• Maven リポジトリの URL

  <dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>3.2.0</version>
  </dependency>

• 検索候補機能のサポートを追加しました。

• 新機能

  • scroll メソッドは、int 型の単一フィールドに基づくソートをサポートします。

  • AppClient で switchTo を使用して、バッチでバージョンを切り替えることができるようになりました。

  • 複数アプリケーション検索のサポートを追加しました。

  • アプリケーションの名前または ID に基づいて、アプリケーションのクォータを取得または更新できるようになりました。

  • 新しい課金モデルのアプリケーションクォータの変更をサポートしました。これには、課金仕様、ストレージ容量、および計算リソースが含まれます。

  • 新しい検索候補機能のサポートを追加しました。

• バグ修正

  各リクエストは使用後に閉じる必要があります。gzip ストリームを返すリクエストを閉じないと、接続が接続プールに返却されません。これにより、接続プールが枯渇し、SDK 全体がハングアップする原因となります。

• Maven リポジトリのアドレス

  <dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>3.1.3</version>
  </dependency>

• 依存関係の競合を減らすために、サードパーティの依存関係は opensearch パッケージに移動されました。slf4j-api コンポーネントを除くすべての依存関係は、opensearch パッケージに再配置されました。

• FULLJSON フォーマットのサポートを追加しました。

• コミットの成功または失敗にかかわらず、コミット後にドキュメントがバッファーからクリアされるようになりました。この変更により、SDK API を使用する際のあいまいさが軽減されます。

• suggest (検索候補) 機能のコンポーネントがオンラインになり、SDK でこの機能が利用できるようになりました。