As mensagens em lote criam um cliente editor com configurações personalizadas e o utilizam para publicar algumas mensagens.
Neste documento, fornecemos 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, conclua as seguintes tarefas:
- Aprenda mais sobre tópicos 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 de Publicador 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 usando papéis personalizados ou outros papéis predefinidos.
Você precisa de permissões adicionais para criar ou atualizar tópicos e assinaturas.
Usar mensagens em lote
Confira os exemplos de código a seguir para saber como definir as configurações de mensagens em lote para seu editor.
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 para 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 para C#.
Go
O exemplo a seguir usa a versão principal da biblioteca de cliente do Pub/Sub para Go (v2). Se você ainda estiver usando a biblioteca v1, consulte o guia de migração para a v2. Para ver uma lista de exemplos de código da v1, consulte os exemplos de código descontinuados.
Antes de testar este 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 para Java (em inglês).
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 para Node.js (em inglês).
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 para Node.js (em inglês).
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 para 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 para Python.
Ruby
O exemplo a seguir usa a biblioteca de cliente do Pub/Sub para Ruby v3. Se você ainda estiver usando a biblioteca v2, consulte o guia de migração para a v3. Para conferir uma lista de exemplos de código do Ruby v2, consulte os exemplos de código descontinuados.
Antes de testar esta amostra, siga as instruções de configuração do Ruby no 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.
Rust
Antes de testar esta amostra, siga as instruções de configuração do Rust 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 Rust.
Desativar mensagens em lote
Para desativar o lote na biblioteca de cliente, defina o valor de
max_messages como 1.
Mensagens em lote e entrega ordenada
Com a entrega ordenada, se você não confirmar qualquer mensagem no lote, todas as mensagens no lote, incluindo as enviadas antes da mensagem que não foi confirmada, serão reenviadas.
Cotas e limites para mensagens em lote
Antes de configurar as mensagens em lote, considere o efeito de fatores como a cota de capacidade de publicação e o 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.
- O tamanho mínimo de solicitação considerado para fins de custo é de 1.000 bytes, 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 as opções avançadas de publicação, consulte: