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