在 Amazon SQS 中使用無效字母佇列 - AWS SDK for JavaScript
使用案例先決條件任務設定來源佇列

我們宣布了即將推 end-of-support 出的 AWS SDK for JavaScript v2。我們建議您移轉至 AWS SDK for JavaScript v3。有關日期，其他詳細信息以及如何遷移的信息，請參閱鏈接的公告。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 Amazon SQS 中使用無效字母佇列

JavaScript code example that applies to Node.js execution

這個 Node.js 程式碼範例會說明：

  • 如何使用佇列來接收和保存其他佇列無法處理的訊息。

使用案例

無效字母佇列即為其他 (來源) 佇列，可以將無法成功處理的訊息當成目標以進行作業。您可以在無效字母佇列中擱置並隔離這類訊息，以確定無法成功處理訊息的原因。而且，您必須針對每個傳送訊息至無效字母佇列的來源佇列，進行個別設定。多個佇列可以將目標設為同一個無效字母佇列。

在此範例中，Node.js 模組可用來將訊息路由至無效字母佇列。Node.js 模組會使用 SDK JavaScript 來使用用AWS.SQS戶端類別的這個方法來使用無效字母佇列：

如需 Amazon SQS 無效字母佇列的詳細資訊，請參閱 Amazon 簡單佇列服務開發人員指南中的使用 Amazon SQS 無效字母佇列。

先決條件任務

若要設定和執行此範例，您必須先完成這些任務：

設定來源佇列

在您建立佇列做為無效字母佇列後，您必須設定其他佇列，用於將未處理的訊息路由到無效字母佇列。若要執行此操作，請指定一個再驅動政策，用以識別當做無效字母佇列的佇列，並指定個別訊息路由到無效字母佇列之前的最大接收量。

以檔名 sqs_deadletterqueue.js 建立一個 Node.js 模組。請務必依前述的內容來設定軟體開發套件。若要存取 Amazon SQS，請建立AWS.SQS服務物件。建立包含更新佇列屬性所需參數的 JSON 物件，其中應包括可指定無效字母佇列 ARN 及 maxReceiveCount 值的 RedrivePolicy 參數。此外，也請指定您要設定的 URL 來源佇列。呼叫 setQueueAttributes 方法。

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the SQS service object
var sqs = new AWS.SQS({ apiVersion: "2012-11-05" });

var params = {
  Attributes: {
    RedrivePolicy:
      '{"deadLetterTargetArn":"DEAD_LETTER_QUEUE_ARN","maxReceiveCount":"10"}',
  },
  QueueUrl: "SOURCE_QUEUE_URL",
};

sqs.setQueueAttributes(params, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

若要執行範例，請在命令列中輸入以下內容。

node sqs_deadletterqueue.js

您可以在這裡找到此範例程式碼 GitHub。