Neste documento, você encontra uma visão geral sobre as mensagens de publicação.
Fluxo de trabalho da publicação de mensagens
Para publicar uma mensagem com o Pub/Sub, um aplicativo editor cria e envia mensagens para um tópico.
- Criar uma mensagem contendo seus dados.
- Selecione qualquer atributo de publicação opcional.
- Envie uma solicitação para o servidor do Pub/Sub publicar a mensagem em um tópico especificado.
O serviço Pub/Sub recebe a mensagem e a processa da seguinte maneira:
A mensagem é armazenada para distribuição.
A mensagem é replicada em várias zonas para oferecer durabilidade e alta disponibilidade.
O Pub/Sub identifica assinantes com assinaturas que correspondem ao tópico da mensagem e entrega uma cópia dela a cada um deles.
O Pub/Sub oferece entrega de mensagens pelo menos uma vez e ordem de melhor esforço para para os assinantes atuais.
Para uma visão geral do sistema do Pub/Sub, consulte Visão geral do serviço Pub/Sub.
Para uma explicação de como o Pub/Sub funciona, consulte Visão geral da arquitetura do Pub/Sub.
Sobre os temas
Um tópico do Pub/Sub é um recurso nomeado que representa um feed de mensagens. Quando um editor envia uma mensagem, ela segmenta um tópico específico. O O serviço Pub/Sub usa esse nome de tópico para rotear a mensagem para todos de assinaturas vinculadas ao tópico. Se houver vários assinantes para um apenas um assinante da assinatura receberá a mensagem.
Os editores não precisam saber quantos assinantes existem. Eles se concentram no tópico, garantindo a separação de preocupações entre o envio de mensagens e recebimento de mensagens.
Replicação de dados em um tópico
Um tópico do Pub/Sub usa três zonas para armazenar dados. O serviço oferece suporte à replicação síncrona em pelo menos duas zonas, e o a replicação para uma terceira zona adicional. A replicação do Pub/Sub é em apenas uma região.
Propriedades de um tópico
Ao criar ou atualizar um tópico, é possível especificar propriedades de tópico.
Sobre as mensagens
Uma mensagem do Pub/Sub são os dados transferidos pelo serviço.
Uma mensagem consiste em campos com os dados e os metadados da mensagem. Uma das opções a seguir: precisa ser especificado em uma mensagem.
Os dados da mensagem: são o conteúdo principal da mensagem e podem ser qualquer texto ou dados binários. Ele representa as informações reais entre editores e assinantes. Se você usa a API REST diretamente, os dados da mensagem precisam ser codificados em base64. Confira o exemplo na guia REST na seção Publicar mensagens.
Uma chave de ordem: é uma identificador que representa a entidade para a qual as mensagens devem ser ordenadas. Mensagens com a mesma chave de ordem devem ser entregues a um assinante na ordem em que foram publicadas. Uma chave de ordem é é obrigatório se você quiser a entrega ordenada das suas mensagens. Para saber mais sobre chaves de ordem, consulte Mensagem do pedido.
Atributos: pares de chave-valor opcionais que oferecem mais contexto e informações sobre a mensagem. Elas podem ser usadas para roteamento, filtrar ou enriquecer o conteúdo da mensagem. Por exemplo, adicione como carimbos de data/hora ou IDs de transações. Para saber mais sobre os atributos usados na publicação de mensagens, consulte Use atributos para publicar uma mensagem.
O serviço Pub/Sub adiciona os seguintes campos à mensagem:
- Um ID de mensagem exclusivo para o tópico
- Carimbo de data/hora de quando o serviço do Pub/Sub recebe a mensagem
Por exemplo, este é um formato de mensagem em JSON:
{
"data": "This is the core message content.",
"attributes": {
"category": "notification",
"user_id": "12345",
"priority": "medium"
},
"orderingKey": "12345"
}