Présentation de Queue

Le service Queue offre les avantages suivants.

Séparation des applications

Queue permet de séparer les applications et les systèmes à l'aide d'une architecture reposant sur les événements. La séparation garantit le redimensionnement indépendant des composants individuels de l'application et la publication dans la file d'attente ou l'abonnement à celle-ci, lorsque des composants d'application sont créés.

Le service Queue utilise les concepts suivants.

message

Un message est un élément d'une file d'attente qui contient une charge utile sous la forme d'une chaîne. La chaîne peut avoir n'importe quel format, y compris XML, JSON, CSV, un message binaire Base64-encoded et même des formats compressés tels que gzip. Les producteurs et les consommateurs devraient se mettre d'accord sur le format du message. Chaque message est traité indépendamment.

émetteur

Client qui envoie des messages à la file d'attente.

destinataire

Client qui reçoit les messages d'une file d'attente. Le destinataire est également responsable de la suppression des messages de la file d'attente après leur réception.

canal

Destination éphémère dans une file d'attente qui peut être créée à la demande. Les messages peuvent être publiés sur un canal spécifique d'une file d'attente et les consommateurs peuvent extraire des messages à partir de canaux spécifiques. Pour plus d'informations, reportez-vous à Canaux.

période de conservation maximale

Durée pendant laquelle une file d'attente conserve un message jusqu'à ce qu'il soit automatiquement supprimé par le système, s'il n'est pas supprimé par un destinataire. La période de conservation maximale peut être configurée sur une valeur comprise entre 10 secondes et 7 jours au niveau de la file d'attente. La valeur par défaut est 1 jour.

nombre de distributions

Nombre de fois qu'un message est distribué à un destinataire sur demande.

nombre maximal de tentatives de distribution

Nombre de fois où un message est distribué à un consommateur, mais pas mis à jour ni supprimé, avant d'être envoyé à une file d'attente de lettres mortes (DLQ). Le nombre maximal de tentatives de distribution peut être configuré sur une valeur comprise entre 1 et 20 au niveau de la file d'attente. Pour plus d'informations, reportez-vous à Nombre de distributions.

délai d'expiration de l'interrogation

Durée pendant laquelle un destinataire doit attendre les messages à utiliser. L'augmentation du délai d'expiration de l'interrogation réduit le nombre de fois qu'un destinataire demande des messages de la file d'attente, mais la réponse indique qu'aucun message n'est disponible pour utilisation. Le délai d'expiration de l'interrogation peut être configuré sur une valeur comprise entre 0 et 30 secondes au niveau de la file d'attente, et les destinataires peuvent définir cette valeur lors de la demande de messages. La valeur par défaut est de 30 secondes. Pour plus d'informations, reportez-vous à Interrogation longue.

délai d'expiration de visibilité

Durée pendant laquelle un message reçu de la file d'attente par un destinataire n'est pas visible par les autres destinataires. Le délai d'expiration de visibilité peut être configuré sur une valeur comprise entre 1 seconde et 12 heures au niveau de la file d'attente, et les destinataires peuvent définir cette valeur lors de la demande de messages. La valeur par défaut est de 30 secondes. Pour plus d'informations, reportez-vous à Verrouillage de message.

messages visibles

Nombre de messages actuellement dans une file d'attente et pouvant être utilisés.

messages en attente de traitement

Nombre de messages distribués à un destinataire mais pas encore supprimés. Les messages en attente de traitement ne peuvent pas être redistribués tant que leur délai d'expiration de visibilité ne s'est pas écoulé.

file d'attente de lettres mortes

Si un message n'est pas utilisé et que le nombre de tentatives de distribution est supérieur au nombre maximal de tentatives de distribution configuré, le message est transféré vers une file d'attente de lettres mortes. Pour plus d'informations, reportez-vous à Files d'attente de lettres mortes.

Le service Queue fournit les garanties suivantes.

• La durabilité d'un message publié est garantie tant qu'il n'est pas supprimé ou que sa période de conservation n'est pas écoulée. La publication d'un message est considérée comme réussie lorsque le service Queue renvoie un accusé de réception à l'émetteur, peu importe si la réponse a été reçue.
• La non-distribution d'un message se trouvant dans le délai d'expiration de visibilité à un autre destinataire est garantie jusqu'à ce que ce délai expire.
• Un message ne sera pas supprimé par le service Queue avant la fin de sa période de conservation. Un destinataire peut traiter et supprimer un message pendant sa période de conservation.

Chaque service d'Oracle Cloud Infrastructure s'intègre à IAM pour l'authentification et l'autorisation, sur toutes les interfaces (consolekit SDK ou interface de ligne de commande, et API REST).

Un administrateur de votre organisation doit configurer des groupes, des compartiments  et des stratégies  qui déterminent les services et les ressources auxquels les utilisateurs peuvent accéder, ainsi que le type d'accès. Par exemple, les stratégies déterminent qui peut créer des utilisateurs, des groupes et des compartiments, ou qui peut créer et gérer des déploiements virtuels.

• Si vous êtes un nouvel administrateur, reportez-vous à Introduction aux stratégies.
• Afin d'obtenir des détails sur l'écriture de stratégies pour ce service, reportez-vous à Stratégies Queue.
• Afin d'obtenir des détails sur l'écriture de stratégies pour les ressources dans d'autres services, reportez-vous à Référence de stratégie.

Vous pouvez accéder à Queue à l'aide de la console (interface basée sur un navigateur), de l'interface de ligne de commande Oracle Cloud Infrastructure ou d'API REST.

Les instructions relatives aux trois méthodes sont incluses dans ce guide.

• La console OCI est une interface simple d'utilisation basée sur un navigateur. Pour accéder à la console, vous devez utiliser un navigateur pris en charge.
• Les API REST fournissent le plus de fonctionnalités, mais nécessitent une expertise en programmation. La page Adresses et référence d'API fournit des détails sur les adresses et des liens vers les documents de référence d'API disponibles, y compris les API Queue.
• OCI fournit des kits SDK qui interagissent avec Queue.
• L'interface de ligne de commande offre un accès rapide et des fonctionnalités complètes sans avoir besoin de programmation.
• Pour utiliser l'interface de ligne de commande OCI ou les API REST, vous pouvez configurer votre environnement ou utiliser Oracle Cloud Infrastructure Cloud Shell.
  • Pour utiliser l'interface de ligne de commande ou les API REST dans Cloud Shell, connectez-vous à la console. Reportez-vous à Utilisation de Cloud Shell et à Référence des commandes de l'interface de ligne de commande.
  • Pour installer l'interface de ligne de commande OCI dans votre environnement, suivez les étapes de démarrage rapide dans Installation de l'interface de ligne de commande.
  • Lorsque vous utilisez des API REST, reportez-vous à la documentation relative aux API REST et à Adresses et référence d'API.

Lors de l'inscription à Oracle Cloud Infrastructure, un ensemble de limites de service est configuré pour la location. La limite de service est l'allocation ou le quota défini sur une ressource. Consultez les limites de service suivantes pour les ressources Queue.

Reportez-vous à Limites de service afin d'en savoir plus sur les limites de service et d'obtenir des instructions pour demander une augmentation de limite. Pour définir des limites propres au compartiment sur une ressource ou une famille de ressources, les administrateurs peuvent utiliser des quotas de compartiment.