Amazon Simple Queue Service
Manuel du développeur

Mise en route d'Amazon SQS

Cette section vous aide à vous familiariser avec Amazon SQS en vous montrant comment gérer les files d'attente et les messages avec AWS Management Console.

Prérequis

Avant de commencer, complétez les étapes détaillées dans Configuration d'Amazon SQS.

Étape 1 : Création d'une file d'attente

La création de files d'attente constitue la principale tâche et la tâche la plus courante d'Amazon SQS. Dans ce didacticiel, vous apprendrez à créer et configurer une file d'attente.

  1. Connectez-vous à la console Amazon SQS.

  2. Choisissez Create New Queue (Créer une file d'attente).

  3. Sur la page Create New Queue (Créer une file d'attente), vérifiez que vous vous trouvez dans la bonne région, puis saisissez le nom de la file d'attente dans le champ Queue Name (Nom de la file d'attente).

    Note

    Le nom d'une file d'attente FIFO doit se terminer par le suffixe .fifo.

  4. Standard est sélectionnée par défaut. Choisissez FIFO.

  5. Pour créer une file d'attente avec les paramètres par défaut, choisissez Quick-Create Queue (Création rapide d'une file d'attente).

    La nouvelle file d'attente est créée et sélectionnée dans la liste des files d'attente.

    Note

    Lorsque vous créez une file d'attente, sa propagation dans tout Amazon SQS peut prendre un peu de temps.

    La colonne Queue Type permet de différencier immédiatement les files d'attente standard des files d'attente FIFO. Pour une file d'attente FIFO, la colonne Content-Based Deduplication indique si vous avez activé le traitement en une seule fois.

    Le nom, l'URL et l'ARN de votre file d'attente s'affichent sous l'onglet Details.

Etape 2 : Envoi d'un message

Une fois la file d'attente créée, vous pouvez lui envoyer un message. L'exemple suivant illustre l'envoi d'un message à une file d'attente existante.

  1. Dans la liste de files d'attente, sélectionnez la file d'attente que vous avez créée.

  2. Dans la liste déroulante Queue Actions, sélectionnez Send a Message.

    La boîte de dialogue Send a Message to QueueName s'affiche.

    L'exemple suivant montre les paramètres de l'ID de groupe de messagerie et de l'ID de déduplication du message spécifiques aux files d'attente FIFO (le paramètre de déduplication basée sur le contenu est désactivé).

  3. Pour envoyer un message à une file d'attente FIFO, saisissez le Message Body, le Message Group ID MyMessageGroupId1234567890 et le Message Deduplication ID MyMessageDeduplicationId1234567890, puis choisissez Send Message. Pour plus d'informations, consultez Logique de remise FIFO.

    Note

    L'ID de groupe de messagerie est toujours obligatoire. Toutefois, si la déduplication basée sur le contenu est activée, l'ID de déduplication du message est facultatif.

    Le message est envoyé et la boîte de dialogue Send a Message to QueueName s'affiche, montrant les attributs du message envoyé.

    L'exemple suivant montre l'attribut Sequence Number spécifique aux files d'attente FIFO.

  4. Choisissez Close.

Etape 3 : Réception et suppression de votre message

Une fois que vous avez envoyé un message à une file d'attente, vous pouvez le consommer (récupérez-le à partir de la file d'attente). Lorsque vous demandez à récupérer un message d'une file d'attente, vous ne pouvez pas préciser le message que vous voulez recevoir. Au lieu de cela, vous spécifiez le nombre maximal de messages (jusqu'à 10) que vous souhaitez recevoir.

Dans ce didacticiel, vous apprendrez à recevoir et supprimer un message.

  1. Dans la liste de files d'attente, sélectionnez la file d'attente que vous avez créée.

  2. Dans la liste déroulante Queue Actions (Actions de file d'attente), sélectionnez View/Delete Messages (Afficher/Supprimer des messages).

    La boîte de dialogue View/Delete Messages in (Afficher/Supprimer les messages dans) QueueName (NomFileAttente) s'affiche.

    Note

    Un écran d'informations s'affiche la première fois que vous effectuez cette action. Pour masquer l'écran, cochez la case Don't show this again (Ne plus afficher cet écran).

  3. Choisissez Start Polling for messages (Démarrer le sondage de messages).

    Amazon SQS commence à interroger les messages dans la file d'attente. La boîte de dialogue affiche un message de la file d'attente. Une barre de progression en bas de la boîte de dialogue affiche l'état de retardement de visibilité du message.

    L'exemple suivant montre les colonnes ID de groupe du message, ID de déduplication du message et Numéro de séquence spécifiques aux files d'attente FIFO.

    Note

    Une fois la barre de progression remplie, le délai de visibilité expire et le message devient visible pour les utilisateurs.

  4. Avant que le délai de visibilité expire, sélectionnez le message que vous souhaitez supprimer, puis choisissez Supprimer 1 message.

  5. Dans la boîte de dialogue Delete Messages (Supprimer des messages), confirmez que le message que vous souhaitez supprimer est coché et choisissez Yes, Delete Checked Messages (Oui, supprimer les messages cochés).

    Le message sélectionné est supprimé.

  6. Sélectionnez Fermer.

Etape 4 : Suppression de votre file d'attente

Si vous n'utilisez pas une file d'attente Amazon SQS (et ne prévoyez pas de l'utiliser dans un avenir proche), il est conseillé de la supprimer d'Amazon SQS. Dans ce didacticiel, vous apprendrez à supprimer une file d'attente.

  1. Dans la liste de files d'attente, sélectionnez la file d'attente que vous avez créée.

  2. Dans la liste déroulante Queue Actions, sélectionnez Delete Queue.

    La boîte de dialogue Delete Queues s'affiche.

  3. Sélectionnez Yes, Delete Queue.

    La file d'attente est supprimée.

Étapes suivantes

Maintenant que vous avez créé une file d'attente, et appris à envoyer, recevoir et supprimer des messages, et à supprimer une file d'attente, vous souhaiterez peut-être essayer les opérations suivantes :