トリガー

Amazon SQS - 新規メッセージトリガー

SQSコネクターは、次のトリガーをサポートしています:

新規メッセージ

新規メッセージトリガーは、定期的なポーリングでSQSキューを確認し、メッセージを取得します。大量のキューには、新規メッセージ（バッチ）トリガーを使用します。

入力フィールド	説明
キュー	メッセージの取得元となるQueue URLを入力します。プロダクションEnvironmentでは、リストから選択しないでください。リストから選択すると、AWS account IDを含む完全なQueue URLが保存されます。これはEnvironment間でデプロイするときに正しく更新されない可能性があります。
メッセージを自動的に削除	トリガーがメッセージを処理した後に自動的に削除するには、はいを選択します。いいえに設定した場合、レシピではメッセージを削除アクションを使用してメッセージを明示的に削除する必要があります。
可視性タイムアウト	可視性タイムアウトの期間（秒単位）を入力します。これにより、`ReceiveMessage`リクエストによって取得されたメッセージは、指定された時間、その後の取得リクエストから非表示になります。最大値は12時間です。詳細については、可視性タイムアウトを参照してください。

出力フィールド	説明
Request ID	リクエストの一意のID。
メッセージ属性のMD5	メッセージ属性のMD5ハッシュ。
メッセージ本文のMD5	メッセージ本文のMD5ハッシュ。
メッセージシステム属性のMD5	メッセージシステム属性のMD5ハッシュ。
メッセージID	メッセージの一意のID。
メッセージ本文	メッセージの内容。
Sequence number	Amazon SQSが各メッセージに割り当てる、大きい非連続の番号。このパラメーターはFIFO（first-in-first-out）キューにのみ適用されます。

新規メッセージ（バッチ）トリガーは、指定したSQSキューを定期的にポーリングしてメッセージを取得します。 Workatoでは、大量のキューにはバッチトリガーを推奨しています。

入力フィールド	説明
キュー	メッセージの取得元となるQueue URLを入力します。プロダクションEnvironmentでは、リストから選択しないでください。リストから選択すると、AWS account IDを含む完全なQueue URLが保存されます。これはEnvironment間でデプロイするときに正しく更新されない可能性があります。
メッセージを自動的に削除	トリガーがメッセージを処理した後に自動的に削除するには、はいを選択します。いいえに設定した場合、レシピではメッセージを削除アクションを使用してメッセージを明示的に削除する必要があります。
可視性タイムアウト	可視性タイムアウトの期間（秒単位）を入力します。これにより、ReceiveMessageリクエストによって取得されたメッセージは、指定された時間、その後の取得リクエストから非表示になります。最大値は12時間です。詳細については、可視性タイムアウトを参照してください。
バッチサイズ（バッチトリガーのみ）	各トリガーイベントのメッセージ最大数を入力します。最小値は10、最大値は2000、デフォルトは2000です。入力値は10の倍数である必要があります。

FIFOキューのメッセージ制限

FIFOキューで新規メッセージバッチトリガーを使用する場合、Amazon SQSは、返されるメッセージ数をバッチサイズの合計ではなく、Message group IDごとに制限します。

Amazon SQSは、関連するメッセージをまとめるMessage group IDによって厳密な順序付けを適用します。 SQSは、同じMessage group IDを持つメッセージを、送信された順序で一度に1つずつ処理します。

そのため、レシピでより大きなバッチサイズを設定しても、トリガーは各メッセージグループから一度に最大10件のメッセージを取得します。これはWorkatoで上書きできないAmazon SQS APIの制限です。

より多くのメッセージを同時に処理するには、メッセージを複数のMessage group IDsに分散するか、同じキューに接続する複数のレシピを実行します。

詳細については、Amazon SQSのFIFOキュー配信ロジックドキュメントを参照してください。

このトリガーへの出力はメッセージのリストです。

出力フィールド	説明
Request ID	リクエストの一意のID。
メッセージ属性のMD5	メッセージ属性のMD5ハッシュ。
メッセージ本文のMD5	メッセージ本文のMD5ハッシュ。
メッセージシステム属性のMD5	メッセージシステム属性のMD5ハッシュ。
メッセージID	メッセージの一意のID。
メッセージ本文	メッセージの内容。
Sequence number	このパラメーターはFIFO（first-in-first-out）キューにのみ適用されます。 Amazon SQSが各メッセージに割り当てる、大きい非連続の番号。

Last updated: