Ce document fournit une présentation de la publication des messages.
Workflow de publication d'un message
Pour publier un message avec Pub/Sub, une application d'éditeur crée et envoie des messages dans un sujet.
- Vous créez un message contenant vos données.
- Sélectionnez des attributs de publication facultatifs.
- Envoyer une requête au serveur Pub/Sub pour publier le message dans un sujet spécifié.
Le service Pub/Sub reçoit le message et le traite de la manière suivante:
Le message est stocké pour être distribué.
Le message est répliqué sur plusieurs zones pour plus de durabilité et de haute disponibilité.
Pub/Sub identifie les abonnés dont les abonnements correspondent au sujet du message et fournit à chacun une copie du message.
Pub/Sub offre aux abonnés existants la distribution des messages au moins une fois et l'ordonnancement dans la mesure du possible.
Pour en savoir plus sur le système Pub/Sub, consultez la page Présentation du service Pub/Sub.
Pour en savoir plus sur le fonctionnement de Pub/Sub, consultez la page Présentation de l'architecture de Pub/Sub.
À propos des thèmes
Un sujet Pub/Sub est une ressource nommée qui représente un flux de messages. Lorsqu'un éditeur envoie un message, il cible un sujet spécifique. Le service Pub/Sub utilise ce nom de sujet pour acheminer le message vers tous les abonnements associés au sujet. S'il y a plusieurs abonnés pour un abonnement, un seul abonné de l'abonnement reçoit le message.
Les éditeurs n'ont pas besoin de connaître le nombre d'abonnés. Ils se concentrent sur le sujet, garantissant la séparation des préoccupations entre l'envoi et la réception des messages.
Réplication de données dans un sujet
Un sujet Pub/Sub utilise trois zones pour stocker les données. Ce service prend en charge la réplication synchrone sur au moins deux zones et la réplication optimale dans une troisième zone supplémentaire. La réplication Pub/Sub se fait dans une seule région.
Propriétés d'un thème
Lorsque vous créez ou mettez à jour un sujet, vous pouvez spécifier ses propriétés.
À propos des messages
Un message Pub/Sub correspond aux données qui transitent par le service.
Un message est constitué de champs contenant des données du message et des métadonnées. L'un des éléments suivants doit être spécifié dans un message.
Données du message: il s'agit du contenu principal du message. Il peut s'agir de n'importe quelle donnée textuelle ou binaire. Il représente les informations réelles que vous souhaitez communiquer entre les éditeurs et les abonnés. Si vous utilisez directement l'API REST, les données des messages doivent être encodées en base64. Consultez l'exemple dans l'onglet REST de la section Publier des messages.
Clé de tri: identifiant qui représente l'entité pour laquelle les messages doivent être ordonnés. Les messages ayant la même clé de tri doivent être distribués à un abonné dans l'ordre de leur publication. Une clé de tri n'est requise que si vous souhaitez que vos messages soient distribués dans l'ordre. Pour en savoir plus sur les clés de tri, consultez la section Message de commande.
Attributes (Attributs) : paires clé/valeur facultatives qui fournissent du contexte et des informations supplémentaires sur le message. Ils peuvent servir à acheminer, filtrer ou enrichir le contenu du message. Par exemple, vous pouvez ajouter des attributs tels que des horodatages ou des ID de transaction. Pour en savoir plus sur les attributs utilisés dans la publication de messages, consultez la section Utiliser des attributs pour publier un message.
Le service Pub/Sub ajoute les champs suivants au message :
- ID de message unique pour le sujet
- Horodatage correspondant au moment où le service Pub/Sub reçoit le message
Voici un exemple de format de message en JSON:
{
"data": "This is the core message content.",
"attributes": {
"category": "notification",
"user_id": "12345",
"priority": "medium"
},
"orderingKey": "12345"
}