Aperçu du service de file d'attente

Le service de file d'attente offre les avantages suivants :

Découplage d'application

Le service de file d'attente permet de découpler les applications et les systèmes à l'aide d'une architecture basée sur les événements. Le découplage fait en sorte que chaque composant d'application soit dimensionné de manière indépendante et que, dès que de nouveaux composants sont intégrés à une application, ils soient en mesure de publier dans la file d'attente ou de s'y abonner.

Le service de file d'attente utilise les concepts suivants.

message

Un message est un élément dans une file d'attente qui contient des données utiles sous la forme d'une chaîne. La chaîne peut être dans 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 s'entendre sur le format du message. Chaque message est traité indépendamment.

producteur

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

consommateur

Client qui reçoit des messages d'une file d'attente. Le consommateur 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 sur demande. Les messages peuvent être publiés sur un canal spécifique d'une file d'attente et les consommateurs peuvent extraire des messages de canaux spécifiques. Pour plus d'informations, voir Canaux.

période de conservation maximale

Durée pendant laquelle une file d'attente conserve un message jusqu'à ce que celui-ci soit automatiquement supprimé par le système, s'il n'est pas supprimé par un consommateur. La période de conservation maximale est configurable à des valeurs de 10 secondes à 7 jours au niveau de la file d'attente. La valeur par défaut est de 1 jour.

nombre de transmissions

Nombre de fois qu'un message est transmis à un consommateur sur demande.

nombre maximal de tentatives de transmission

Nombre de fois qu'un message est transmis à un consommateur, mais qu'il n'a pas été mis à jour ou supprimé, avant d'être envoyé dans une file d'attente de lettres mortes (DLQ). Le nombre maximal de tentatives de transmission est configurable à des valeurs de 1 à 20 au niveau de la file d'attente. Pour plus d'informations, voir Nombre de transmissions.

temporisation de scrutation

Durée pendant laquelle un consommateur attendra que les messages soient consommés. L'augmentation de la temporisation de scrutation réduit le nombre de fois qu'un consommateur demande des messages de la file d'attente, mais la réponse indique qu'il n'y a aucun message disponible à consommer. La temporisation de scrutation est configurable à des valeurs de 0 à 30 secondes au niveau de la file d'attente et les consommateurs peuvent définir la valeur lors de la demande de messages. La valeur par défaut est de 30 secondes. Pour plus d'informations, voir Scrutation longue.

temporisation de visibilité

Durée pendant laquelle un message reçu de la file d'attente par un consommateur n'est pas visible pour les autres consommateurs. La temporisation de visibilité est configurable à des valeurs de 1 seconde à 12 heures au niveau de la file d'attente et les consommateurs peuvent définir la valeur lors de la demande de messages. La valeur par défaut est de 30 secondes. Pour plus d'informations, voir Verrouillage de message.

messages visibles

Nombre de messages actuellement en file d'attente disponibles pour consommation.

messages en cours

Nombre de messages transmis à un consommateur, mais pas encore supprimés. Les messages en cours ne sont pas disponibles pour une nouvelle transmission tant que leur temporisation de visibilité n'a pas expiré.

file d'attente des messages non distribués

Si un message n'est pas consommé et qu'il présente plus de tentatives de transmission que le nombre maximal configuré, il est transféré dans une file d'attente des messages non distribués. Pour plus d'informations, voir Files d'attente des messages non distribués.

Le service de file d'attente offre les garanties suivantes :

• La durabilité d'un message publié est garantie jusqu'à ce qu'il soit supprimé ou que sa période de conservation soit écoulée. La publication d'un message est considérée comme réussie lorsque le service de file d'attente renvoie un accusé de réception au producteur. Il importe peu que la réponse ait été reçue.
• Un message dans la temporisation de visibilité est garanti de ne pas être transmis à un autre consommateur jusqu'à ce que cette temporisation expire.
• Un message ne sera pas supprimé par le service de file d'attente avant la fin de sa période de conservation. Un consommateur peut traiter et supprimer un message pendant sa période de conservation.

Chaque service d'Oracle Cloud Infrastructure est intégré avec le service GIA aux fins d'authentification et d'autorisation, pour toutes les interfaces (console, trousse SDK ou interface de ligne de commande et API REST).

Un administrateur de votre organisation doit configurer des groupes, des compartiments  et des politiques  qui déterminent quels utilisateurs peuvent accéder à quels services et ressources, ainsi que le type d'accès dont ils disposent. Par exemple, les politiques contrôlent les autorisations de création d'utilisateurs, de groupes et de compartiments, ou de création et de gestion des déploiements virtuels.

• Si vous êtes un nouvel administrateur, voir Introduction aux politiques.
• Pour plus de détails sur l'écriture de politiques pour ce service, voir Politiques de file d'attente.
• Pour plus de détails sur l'écriture de politiques pour les ressources d'autres services, voir Informations de référence sur les politiques.

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

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

• La console OCI est une interface facile à utiliser basée sur un navigateur. Pour accéder à la console, vous devez utiliser un navigateur pris en charge.
• Les API REST offrent le plus de fonctionnalités, mais nécessitent des connaissances en programmation. La rubrique Informations de référence sur les API et points d'extrémité d'API fournit des détails sur les points d'extrémité et des liens vers les documents de référence sur les API, y compris les API du service de file d'attente.
• OCI fournit des trousses SDK qui interagissent avec le service de file d'attente.
• L'interface de ligne de commande fournit un accès rapide et des fonctionnalités complètes, sans programmation.
• Pour utiliser l'interface de ligne de commande OCI ou les API REST, vous pouvez configurer votre environnement ou utiliser Cloud Shell pour Oracle Cloud Infrastructure.
  • Pour utiliser l'interface de ligne de commande ou les API REST dans Cloud Shell, connectez-vous à la console. Voir Utilisation de Cloud Shell et Informations de référence sur l'interface de ligne de commande.
  • Pour installer l'interface de ligne de commande OCI dans votre environnement, suivez les étapes décrites dans le démarrage rapide Installation de l'interface de ligne de commande.
  • Pour utiliser les API REST, consultez la documentation sur les API REST et les Informations de référence sur les API et points d'extrémité d'API.

Lorsque vous vous abonnez à Oracle Cloud Infrastructure, un jeu de limites de service est configuré pour votre location. La limite de service correspond au quota défini pour une ressource. Vérifiez les limites de service suivantes pour les ressources de file d'attente.

Voir Limites de service pour en savoir plus sur les limites de service et trouver des instructions pour demander l'augmentation d'une limite. Pour définir des limites propres à un compartiment pour une ressource ou une famille de ressources, les administrateurs peuvent utiliser des quotas de compartiment.