Upgrading and Migrating Amazon SQS Connector - Mule 4
Upgrade Anypoint Connector for Amazon SQS to 5.8 to take advantage of the ability to send and receive large messages.
Amazon SQS Connector now supports sending and receiving large messages with payloads of up to 2 GB. This is beneficial when your application requires large amounts of data to be stored in queues.
|This feature requires the use of the Amazon S3 service. Large payload transmissions are billed as one SQS request and one S3 request. Billing for the payload is based on the amount of data stored in Amazon S3.|
The Messages object now contains a new
deduplicationId field. If multiple messages are sent with the same deduplication ID, Amazon SQS accepts the messages successfully, but delivers only the first message during the 5-minute deduplication interval.
Cluster node support was added back to the
Receive Messages input source and works the same as it did in version 5.4.3. The input source listens for messages on all cluster nodes by default, but you can change this behavior by using the
Primary node only field on the
Advanced sub-tab on the
Receive Messages tab. For more information, see Receiving Messages in Cluster Mode.
Ensure your system meets the following requirements before you perform the upgrade:
4.1.1 and later
7.0 and later
See the Amazon SQS Connector Release Notes for updated compatibility information for patch updates.
Before you upgrade, create a backup of your files, data, and configurations in case you need to restore them.
Follow these steps to perform the upgrade:
In Anypoint Studio, create a Mule project.
In the Mule Palette view, click Search in Exchange.
sqsin the search field.
In the Available modules section, select Amazon SQS Connector and click Add.
Verify that the
mule-amazon-sqs-connectordependency version is
pom.xmlfile in the Mule project. Replace
xwith the version that corresponds to the connector you are using.
In version 5.5.0, the
Receive Messagesinput source received messages on the primary node only. To obtain the same behavior in this version, access the Advanced tab in the Receive Messages source operation configuration and select the Primary node only field.
If you’re upgrading from version 5.4.x or earlier to version 5.8, this step is not needed.
Studio upgrades the connector automatically.
After you install the latest version of the connector, verify the upgrade:
In Studio, verify that there are no errors in the Problems or Console views.
Verify that there are no problems in the project
Test the connection and verify that the operations work.
If there are problems with caching the parameters and metadata, try restarting Studio.
If you must revert to your previous version of Amazon SQS Connector, change the
mule-amazon-sqs-connector dependency version
5.8.x in the project’s
pom.xml to the latest version which is not deprecated,