As mensagens em lote criam um cliente editor com configurações de lote personalizadas e o usam para publicar algumas mensagens.
Este documento fornece informações sobre o uso de mensagens em lote com mensagens publicadas em um tópico.
Antes de começar
Antes de configurar o fluxo de trabalho de publicação, verifique se você concluiu as seguintes tarefas:
- Saiba mais sobre temas e o fluxo de trabalho de publicação.
- Crie um tópico.
Funções exigidas
Para receber as permissões necessárias para
publicar mensagens em um tópico,
peça ao administrador para conceder a você o
papel do IAM Publisher do Pub/Sub (roles/pubsub.publisher
)
no tópico.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
Você precisa de permissões adicionais para criar ou atualizar tópicos e assinaturas.
Usar mensagens em lote
Consulte os exemplos de código a seguir para saber como configurar as opções de mensagens em lote para seu publisher.
C++
Antes de tentar esse exemplo, siga as instruções de configuração do C++ em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
C#
Antes de tentar esse exemplo, siga as instruções de configuração do C# em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Go
O exemplo a seguir usa a versão principal da biblioteca de cliente do Go Pub/Sub (v2). Se você ainda estiver usando a biblioteca v1, consulte o guia de migração para a v2. Para conferir uma lista de exemplos de código da v1, consulte os exemplos de código descontinuados.
Antes de tentar esse exemplo, siga as instruções de configuração do Go em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de tentar essa amostra, siga as instruções de configuração do Java em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Node.js
Antes de tentar essa amostra, siga as instruções de configuração do Node.js em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
Node.js
Antes de tentar essa amostra, siga as instruções de configuração do Node.js em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
PHP
Antes de tentar esse exemplo, siga as instruções de configuração do PHP em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Python
Antes de tentar esse exemplo, siga as instruções de configuração do Python em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Python.
Ruby
Antes de tentar esse exemplo, siga as instruções de configuração do Ruby em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Desativar mensagens em lote
Para desativar o agrupamento em lote na biblioteca de cliente, defina o valor de
max_messages
como 1.
Mensagens em lote e entrega ordenada
Com a entrega ordenada, não confirmar uma mensagem no lote significa que todas as mensagens no lote, incluindo as enviadas antes da mensagem que não foi confirmada, serão entregues novamente.
Cotas e limites para mensagens em lote
Antes de configurar o envio de mensagens em lote, considere o efeito de fatores como cota de capacidade de publicação e tamanho máximo de um lote. As bibliotecas de cliente de alto nível garantem que as solicitações em lote sejam mantidas dentro dos limites especificados.
- 1.000 bytes é o tamanho mínimo de solicitação considerado para fins de custo, mesmo que o tamanho real da mensagem seja menor que 1.000 bytes.
- O Pub/Sub tem um limite de 10 MB ou 1.000 mensagens para uma única solicitação de publicação em lote.
Para mais informações, consulte Cotas e limites do Pub/Sub.
A seguir
Para saber como configurar opções avançadas de publicação, consulte: