すべてのプロダクト
Search
ドキュメントセンター

ApsaraMQ for RocketMQ:コンシューマーの種類

最終更新日:Aug 08, 2026

ApsaraMQ for RocketMQ には、プッシュコンシューマーとシンプルコンシューマーの 2 種類のコンシューマーが用意されています。各タイプは、メッセージの取得方法、同時実行数、リトライ処理をそれぞれ異なる方法で実現します。ご自身の処理モデルおよび信頼性要件に合ったタイプを選択してください。

コンシューマータイプの選択

シナリオ推奨タイプ理由
処理時間が予測可能で、カスタムスレッド管理を行わない場合プッシュコンシューマーSDK がメッセージのフェッチ、同時実行数、リトライを管理します。リスナーを登録し、各メッセージを処理して結果を返すだけです。
処理時間が可変で、カスタムワークフローが必要な場合シンプルコンシューマーアプリケーション側でメッセージのフェッチタイミング、スレッド間でのディストリビューション方法、完了の通知タイミングを制御できます。
説明

コンシューマータイプを切り替えても、既存の ApsaraMQ for RocketMQ リソースやビジネスプロセスには影響しません。

メッセージ処理のステージ

どちらのコンシューマータイプも、以下の 3 ステージのライフサイクルに従います。

  1. 受信 — サーバーからメッセージをフェッチします。

  2. 処理 — 各メッセージに対してビジネスロジックを実行します。

  3. コミット — サーバーに処理結果(成功または失敗)を報告します。

Message consumption flow

両タイプは、各ステージの処理方法が異なります。

機能プッシュコンシューマーシンプルコンシューマー
インターフェースリスナーコールバック — リスナー内でロジックを実装し、結果を返しますアプリケーションが API オペレーションを呼び出して、メッセージの受信、処理、確認応答を行います
同時実行SDK が管理アプリケーションが管理
柔軟性高度にカプセル化されており、柔軟性は低めアトミックな操作で、高度にカスタマイズ可能
最適な用途処理時間が予測可能な標準的な消費処理カスタムワークフロー、非同期ディストリビューション、バッチ消費処理
SDK クラスPushConsumer、LitePushConsumerSimpleConsumer

プッシュコンシューマー

プッシュコンシューマーは、メッセージのフェッチ、スレッド管理、リトライロジックをカプセル化しています。初期化時にメッセージリスナーを登録すると、以降の処理は SDK が自動で行います。

仕組み

SDK は内部で Reactor スレッドモデルを使用します。

  1. 組み込みのロングポーリングスレッドが、非同期にサーバーからメッセージをプルします。

  2. メッセージは内部のキャッシュキューに格納されます。

  3. SDK がコンシューマースレッドにメッセージをディスパッチし、リスナーを呼び出します。

PushConsumer internal mechanism

リスナーの結果

メッセージリスナーは、以下のいずれかの結果を返す必要があります。

結果Java SDK 定数動作
成功ConsumeResult.SUCCESSサーバーが消費進捗を更新します。
失敗ConsumeResult.FAILUREプッシュコンシューマーのリトライポリシーに基づいてシステムが再試行します。
例外がスローされた場合(失敗として扱われる)明示的な失敗と同じリトライ動作になります。

タイムアウト時の動作

処理ロジックがブロックされ、許容時間内にメッセージ処理が完了しない場合、SDK は強制的に失敗結果を送信し、リトライポリシーに従ってメッセージを処理します。

説明

タイムアウトにより SDK が失敗結果を送信しますが、現在の処理スレッドは割り込みに応答せず、引き続き実行を続ける可能性があります。

信頼性に関する制約

プッシュコンシューマーは、リスナーの戻り値のみに基づいて成功または失敗を厳密に判断します。この保証を維持するため、以下の点に注意してください。

  1. 同期的に処理する。 結果を返す前に、すべての処理を完了させてください。

  2. メッセージを再配布しない。 メッセージを他のスレッドに渡して、それらのスレッドが完了する前に結果を返さないでください。

リスナーが処理完了前に成功を返し、その後処理が失敗した場合、サーバーはそのメッセージを正常に消費されたものと見なし、再試行を行いません。

順序付きメッセージの配信

コンシューマーグループが順序付き消費モードを使用している場合、プッシュコンシューマーは追加の構成なしに、厳密なメッセージ順序でリスナーを呼び出します。詳細については、「順序付きメッセージ」をご参照ください。

説明

順序付き配信には同期的処理が必要です。リスナー内でカスタムの非同期ディストリビューションを行うと、順序保証が無効になります。

プッシュコンシューマーの適用範囲

プッシュコンシューマーは、以下の条件を満たす場合に最適です。

  • 処理時間が予測可能である。 処理時間が予測できないと頻繁にタイムアウトが発生し、リトライによって重複メッセージが発生します。

  • 標準的な消費処理で十分である。 SDK がスレッドモデルを制御し、最大スループットでメッセージを配信します。これにより開発が簡素化されますが、非同期処理やカスタムレート制御はサポートされません。

SDK クラス

ApsaraMQ for RocketMQ では、プッシュコンシューマー向けに以下の 2 つの SDK クラスを提供しています。

  • PushConsumer — 標準(Lite 以外)トピックからのメッセージを消費します。

  • LitePushConsumer — Lite タイプのトピックからのメッセージを消費し、Lite トピック単位で消費制御を行います。

PushConsumer の例

// PushConsumer を使用して通常メッセージを消費します
ClientServiceProvider provider = ClientServiceProvider.loadService();
String topic = "<your-topic>";
FilterExpression filterExpression = new FilterExpression("<your-filter-tag>", FilterExpressionType.TAG);

PushConsumer pushConsumer = provider.newPushConsumerBuilder()
        // コンシューマーグループを設定します
        .setConsumerGroup("<your-consumer-group>")
        // アクセスエンドポイントを設定します
        .setClientConfiguration(ClientConfiguration.newBuilder().setEndpoints("<your-endpoint>").build())
        // サブスクリプションをバインドします
        .setSubscriptionExpressions(Collections.singletonMap(topic, filterExpression))
        // メッセージリスナーを登録します
        .setMessageListener(new MessageListener() {
            @Override
            public ConsumeResult consume(MessageView messageView) {
                // メッセージを処理し、結果を返します
                return ConsumeResult.SUCCESS;
            }
        })
        .build();

以下のプレースホルダーを実際の値に置き換えてください。

プレースホルダー説明例
<your-topic>トピック名order-events
<your-filter-tag>フィルタリング用のメッセージタグpayment
<your-consumer-group>コンシューマーグループ名order-service-group
<your-endpoint>サーバーアクセスエンドポイント--

LitePushConsumer の例

// LitePushConsumer を使用して通常メッセージを消費します
ClientServiceProvider provider = ClientServiceProvider.loadService();

LitePushConsumer litePushConsumer = provider.newLitePushConsumerBuilder()
        // アクセスエンドポイントを設定します
        .setClientConfiguration(ClientConfiguration.newBuilder().setEndpoints("<your-endpoint>").build())
        // トピックを設定します
        .bindTopic("<your-topic>")
        // コンシューマーグループを設定します
        .setConsumerGroup("<your-consumer-group>")
        // メッセージリスナーを登録します
        .setMessageListener(messageView -> {
            // メッセージを処理し、結果を返します
            return ConsumeResult.SUCCESS;
        })
        .build();

// Lite トピックをサブスクライブします
litePushConsumer.subscribeLite("<your-lite-topic-1>");
litePushConsumer.subscribeLite("<your-lite-topic-2>");

シンプルコンシューマー

シンプルコンシューマーは、メッセージ処理のためのアトミックな API オペレーションを提供します。アプリケーション側で、メッセージのフェッチ、スレッド管理、確認応答を直接制御できます。

仕組み

  1. ReceiveMessage を呼び出して、サーバーからメッセージのバッチをプルします。

  2. メッセージをビジネススレッドにディストリビュートして処理します。

  3. 正常に処理された各メッセージに対して AckMessage を呼び出します。

処理が失敗した場合は、確認応答を送信しないでください。メッセージの非表示期間が終了すると、メッセージは再度利用可能になり、リトライがトリガーされます。詳細については、「シンプルコンシューマーのリトライポリシー」をご参照ください。

API オペレーション

オペレーション目的主なパラメーター
ReceiveMessageサーバーからメッセージをプルするバッチサイズ: 1 回のリクエストあたりのメッセージ数。メッセージ非表示期間: メッセージが再配信されるまでの最大処理時間。
AckMessage正常な消費を確認応答するなし
ChangeInvisibleDurationすでに受信済みのメッセージの処理時間を延長するメッセージ非表示期間: 新しい値。通常、処理に当初の想定より時間がかかる場合に使用します。
説明

サーバーは分散ストレージを使用しているため、メッセージが存在していても ReceiveMessage が空の結果を返すことがあります。これを回避するには、ReceiveMessage を再度呼び出すか、呼び出しの同時実行数を増やしてください。

障害時の処理

以下の表は、さまざまな障害シナリオがメッセージ配信に与える影響を示しています。

障害シナリオ動作
処理が失敗(ACK 未送信)非表示期間が終了すると、メッセージが再度表示され、サーバーが再配信してリトライを実行します。
処理が非表示期間を超えたACK 未送信時と同じ動作 — メッセージが再度表示され、再配信されます。ChangeInvisibleDuration を使用して、非表示期間が終了する前に処理ウィンドウを延長できます。
ACK 送信前にコンシューマーがクラッシュ非表示期間が終了すると、メッセージが再配信されます。

順序付きメッセージの配信

シンプルコンシューマーは、順序付きメッセージをストレージ順に処理します。シーケンスを維持する必要のあるメッセージグループでは、先行メッセージの処理が完了するまで次のメッセージを取得できません。

シンプルコンシューマーの適用範囲

シンプルコンシューマーは、以下の条件を満たす場合に最適です。

  • 処理時間が予測不可能である。 ReceiveMessage 呼び出し時に初期のメッセージ非表示期間を指定し、必要に応じて ChangeInvisibleDuration で延長できます。

  • カスタムワークフローが必要である。 SDK はスレッドモデルを強制しないため、非同期ディストリビューション、バッチ消費、任意のカスタムパターンを実装できます。

  • レート制御が重要である。 アプリケーションコードが ReceiveMessage を呼び出すタイミングと頻度を決定するため、スループットを直接制御できます。

SDK クラス

ApsaraMQ for RocketMQ では、シンプルコンシューマー向けに SimpleConsumer という 1 つの SDK クラスを提供しています。このクラスは、Lite トピックからのメッセージを消費することはできません。

SimpleConsumer の例

// SimpleConsumer を使用して通常メッセージを消費します
ClientServiceProvider provider = ClientServiceProvider.loadService();
String topic = "<your-topic>";
FilterExpression filterExpression = new FilterExpression("<your-filter-tag>", FilterExpressionType.TAG);

SimpleConsumer simpleConsumer = provider.newSimpleConsumerBuilder()
        // コンシューマーグループを設定します
        .setConsumerGroup("<your-consumer-group>")
        // アクセスエンドポイントを設定します
        .setClientConfiguration(ClientConfiguration.newBuilder().setEndpoints("<your-endpoint>").build())
        // サブスクリプションをバインドします
        .setSubscriptionExpressions(Collections.singletonMap(topic, filterExpression))
        .build();

try {
    // 最大 10 件のメッセージをプルし、最大 30 秒待機します
    List<MessageView> messageViewList = simpleConsumer.receive(10, Duration.ofSeconds(30));
    messageViewList.forEach(messageView -> {
        System.out.println(messageView);
        // 正常に処理された各メッセージを確認応答します
        try {
            simpleConsumer.ack(messageView);
        } catch (ClientException e) {
            e.printStackTrace();
        }
    });
} catch (ClientException e) {
    // スロットリングなどの障害を処理し、receive 呼び出しを再試行します
    e.printStackTrace();
}

ベストプラクティス

プッシュコンシューマーの処理時間制御

メッセージ処理をタイムアウトしきい値内に収めてください。頻繁なタイムアウトは不要なリトライと重複メッセージを引き起こします。アプリケーションで長時間実行タスクを定期的に処理する場合は、シンプルコンシューマーに切り替えて、適切なメッセージ非表示期間を設定してください。

LitePullConsumer から SimpleConsumer への移行

LitePullConsumer は、Apache RocketMQ 4.x Remoting SDK におけるコンシューマータイプでした。5.x gRPC SDK では削除されており、Go、Java、Python の 5.x SDK ではこのタイプは提供されていません。

以前、プルベースの消費処理に LitePullConsumer を使用していた場合は、5.x SDK へのアップグレード後に SimpleConsumer へ移行してください。SimpleConsumer は以下のオペレーションを提供します。

  • ReceiveMessage:オンデマンドでサーバーからメッセージをプルします。

  • AckMessage:正常な消費を確認応答します。

  • ChangeInvisibleDuration:メッセージ非表示期間を変更して、リトライ間隔を制御します。

Go SDK では、対応するメソッドは Receive および Ack です。Java SDK では、対応するメソッドは receive および ack です。