Solace - キューからメッセージバッチを受信アクション ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Receive messages batch from queueアクションは、指定したSolaceキューからメッセージのバッチを受信します。

入力 ​

入力フィールド説明
キュー名メッセージの受信元のキューを選択します。
メッセージ形式メッセージ形式を選択します。オプションはBinaryとテキストです。
バッチサイズ任意。受信するメッセージの最大数を入力します。最小値は1、最大値は1000です。デフォルトは10です。
タイムアウト(ms)任意。メッセージの最大待機時間をミリ秒単位で入力します。最小値は1、最大値は300,000です。デフォルトは30,000です。
セレクター任意。特定のメッセージを選択するためのフィルター式を入力します。例:property='value'。プロパティ名では大文字と小文字が区別されます。
手動確認応答任意。レシピがAcknowledge messageアクションでバッチ全体を確定するまで、ブローカー上でそのバッチ全体を未アクノリッジのまま保持するかどうかを選択します。このアクションは、バッチ内のすべてのメッセージを1つの単位として受理、失敗、または拒否します。デフォルトはNoであり、この場合、アクションの出力が生成されるとすぐにバッチがアクノリッジ(受理)され、後でレシピジョブが失敗した場合でも、そのバッチ内のすべてのメッセージはキューから完全に削除されます。ジョブは保持されており再実行できますが、ブローカーはそのバッチ内のメッセージを再配信しません。オンプレミスエージェントのバージョン34以降が必要です。以前のバージョンからエージェントを更新するには、Upgrade your agentを参照してください。
確認応答タイムアウト(ms)任意。ブローカーがAcknowledge messageアクションによるバッチの確定をあきらめるまで待機するミリ秒数を入力します。レシピがこの時間内にアクノリッジ処理を完了しない場合、Solaceはバッチ全体が失敗したものとして扱い、将来の受信試行のためにそのバッチをキューへ再配信し、元のアクノリッジ試行を失敗として扱います。デフォルトは60,000です。

出力 ​

出力フィールド説明
確認応答ハンドルバッチ全体を手動でアクノリッジするための、不透明な識別ハンドルです。バッチ内のすべてのメッセージを確定するために、このハンドルをAcknowledge messageアクションのAcknowledgement handleフィールドに渡します。
メッセージ数受信したメッセージの数。
メッセージ受信したメッセージ。各メッセージには、Messagesに記載されているフィールドが含まれます。

メッセージ ​

出力フィールド説明
確認応答ハンドルアクションのトップレベルフィールドと同じAcknowledgement handleであり、Messagesを反復処理する際に便利なようにここに再掲されています。
| メッセージタイプ受信したメッセージペイロードの形式。例えば: text。
| 配信モードメッセージ送信時の配信モード。 PERSISTENT メッセージは、配信、確認応答、または有効期限切れになるまでブローカーに保存されます。 DIRECT メッセージは保存されず、サブスクライバーが受信できる状態でない場合は破棄されることがあります。
| 優先度メッセージの配信優先度。これは、キューで優先度順の配信が有効になっている場合にのみ配信順序に影響します。
| サービスクラスメッセージのサービスクラス。宛先キューが輻輳している場合に、ブローカーがどの程度優先的にメッセージを破棄するかを決定します。
| 宛先メッセージが配信されたキューまたはトピック。含まれる項目:
  • タイプ
  • 名前
| 返信先送信側が指定している場合に、返信を送信する宛先。含まれる項目:
  • タイプ
  • 名前
| アプリケーションID送信側が設定した場合の、送信アプリケーションのID。
| アプリケーションタイプ送信側が設定した場合の、送信アプリケーションのメッセージタイプ。
| HTTPコンテンツタイプ送信側が設定した場合の、メッセージのHTTPコンテンツタイプ。
| 相関ID送信側が設定した場合の、関連メッセージを追跡するための識別子。
| 送信者IDメッセージを送信したクライアントの識別子。送信側が設定した場合。
| レプリケーショングループIDメッセージのレプリケーショングループID。Solace のデータレプリケーションに使用されます。
| シーケンス番号送信側が設定した場合の、メッセージのシーケンス番号。
| 送信時刻送信者側のタイムスタンプ, ミリ秒単位。送信側が設定した場合。
| 受信時刻メッセージが受信された時刻のタイムスタンプ, ミリ秒単位。
| 有効期間メッセージ送信時に設定された, ブローカーによって適用される有効期間, ミリ秒単位。これは実際にメッセージの有効期限を制御し、対象となる場合はメッセージをデッドメッセージキューへルーティングします。 0 はメッセージが有効期限切れにならないことを意味します。
| 有効期限情報提供用の有効期限タイムスタンプヘッダー, ミリ秒単位。設定されている場合。 Time to live と異なり、ブローカー上でメッセージの有効期限を切らせることはありません。
| 配信回数このメッセージが配信された回数。
| 返信フラグこのメッセージが、Solace のリクエスト・リプライメッセージングパターンで、以前のリクエストに対する返信かどうか。
| デッドメッセージキュー対象メッセージが配信不能となった場合に、デッドメッセージキューへルーティング可能かどうか。
| 破棄インジケーター例えばバッファのフルなどにより, このメッセージの前に複数のメッセージが破棄されているかどうか。
| 省略対象ブローカーが高速なトピック更新の連続を間引きして, 遅いサブスクライバーには最新の値のみを届ける「省略 (eliding)」の対象となるかどうか。ダイレクトメッセージにのみ適用されます。
| ユーザーデータ送信側が設定した場合の、base64エンコードされた任意のユーザーデータ。
| プロパティメッセージのカスタムプロパティ。含まれる項目:
  • 名前
  • タイプ
  • 値
  • リストサイズ: プロパティの数。
  • リストインデックス: リスト内におけるプロパティの位置。
| Messageメッセージペイロード。
| List size受信したメッセージ数。
| List indexリスト内でのメッセージの位置。

最終更新日: