批量消息传递功能会创建一个具有自定义批处理设置的发布者客户端,并使用该客户端来发布一些消息。
本文档介绍了如何将批量消息与发布到主题的消息搭配使用。
准备工作
在配置发布工作流之前,请确保您已完成以下任务:
所需的角色
如需获得向主题发布消息所需的权限,请让您的管理员为您授予相应主题的 Pub/Sub Publisher (roles/pubsub.publisher
) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
您需要额外的权限才能创建或更新主题和订阅。
使用批量消息传递功能
如需了解如何为发布商配置批量消息传递设置,请参阅以下代码示例。
C++
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 C++ 设置说明进行操作。如需了解详情,请参阅 Pub/Sub C++ API 参考文档。
C#
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 C# 设置说明进行操作。 如需了解详情,请参阅 Pub/Sub C# API 参考文档。
Go
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 Go 设置说明进行操作。 如需了解详情,请参阅 Pub/Sub Go API 参考文档。
Java
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 Java 设置说明进行操作。 如需了解详情,请参阅 Pub/Sub Java API 参考文档。
Node.js
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情,请参阅 Pub/Sub Node.js API 参考文档。
Node.js
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 Node.js 设置说明进行操作。如需了解详情,请参阅 Pub/Sub Node.js API 参考文档。
PHP
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 PHP 设置说明进行操作。如需了解详情,请参阅 Pub/Sub PHP API 参考文档。
Python
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 Python 设置说明进行操作。 如需了解详情,请参阅 Pub/Sub Python API 参考文档。
Ruby
在尝试此示例之前,请按照《快速入门:使用客户端库》中的 Ruby 设置说明进行操作。 如需了解详情,请参阅 Pub/Sub Ruby API 参考文档。
停用批量消息传递功能
如需在客户端库中停用批处理,请将 max_messages
的值设置为 1。
批量消息传递和有序传送
在有序传送的情况下,如果未确认批次中的任何消息,则意味着批次中的所有消息(包括在未确认的消息之前发送的消息)都会重新传送。
批量消息传送的配额和限制
在配置批量消息传递之前,请考虑发布吞吐量配额和批量大小上限等因素的影响。高级客户端库可确保将批量请求保持在指定限制范围内。
- 出于费用考虑,我们将 1000 字节视为最小请求大小,即使实际消息大小可能小于 1000 字节也是如此。
- 对于单个批量发布请求,Pub/Sub 限制为 10 MB 的大小或 1,000 条消息。
如需了解详情,请参阅 Pub/Sub 配额和限制。
后续步骤
如需了解如何配置高级发布选项,请参阅以下内容: