本文档介绍了如何使用和管理 Pub/Sub Lite 预留。本文档还介绍了容量单位的概念,以及如何确定满足应用吞吐量所需的容量单位数。
精简版预留概览
精简版预留预配在一个区域中的一个或多个精简版主题之间动态共享吞吐量容量。这些主题可以是区域级或可用区级精简版主题。与设置各个精简版主题的吞吐量容量相比,使用精简版预留是更好的选择。借助精简版预留,您可以管理和监控更少的资源。此外,您不必选择各个精简版主题的吞吐量容量。
如需使用精简版预留,请将位于同一区域的精简版主题附加到特定精简版预留。您可以将单个精简版预留同时附加到可用区级和区域级精简版主题。挂接到精简版预留的精简版主题中的所有分区都会动态消耗精简版预留中预配的吞吐量容量。如果您确实为精简版主题指定了精简版预留,还可以添加速率限制以限制精简版主题中每个分区的吞吐量容量。
容量单位概览
精简版预留的吞吐量容量以容量单位为单位预配。
一个容量单位对应于以下吞吐量:
精简版主题类型 | 发布吞吐量 (MiBps) | 订阅吞吐量 (MiBps) |
---|---|---|
可用区级 | 1 | 2 |
区域 | 0.25 | 0.5 |
预留命名准则
Pub/Sub Lite 资源名称唯一标识 Pub/Sub Lite 资源,例如主题、订阅或预留。资源名称必须符合以下格式:
projects/project-identifier/collection/ID
project-identifier
:必须是 Google Cloud 控制台中的项目 ID 或项目编号。例如,my-cool-project
是项目 ID。123456789123
是项目编号。collection
:必须是topics
、subscriptions
或reservations
中的一个。ID
:必须符合以下准则:- 不能以字符串
goog
开头 - 以字母开头
- 包含 3 到 255 个字符
- 仅包含以下字符:字母
[A-Za-z]
、数字[0-9]
、短划线-
、下划线_
、句点.
、波形符~
、加号+
和百分号%
您可以在不进行网址编码的资源名称中使用上述列表中的特殊字符。不过,在网址中使用任何其他特殊字符时,您必须确保这些字符经过正确编码或解码。例如,
mi-tópico
是无效的 ID。不过,mi-t%C3%B3pico
是有效的。在进行 REST 调用时,此格式非常重要。- 不能以字符串
精简版预留使用准则
对于区域级精简版主题,必须使用精简版预留预配吞吐量;对于可用区级精简版主题,预配吞吐量可选。精简版预留属于区域级资源。
计划配置精简版预留时,请注意以下事项:
精简版预留所需的容量单元数量必须与相应精简版预留中所有主题和订阅在任意给定一分钟内的预期峰值吞吐量相等。
当精简版预留中所有精简版主题的吞吐量总和达到其容量时,发布和传送会受到限制。Pub/Sub Lite 服务器停止向客户端发送消息,消息在发布者客户端中进行缓冲。您可以为
reservation/throughput_capacity/utilization
设置提醒,以便在预留存在受到限制的危险时收到通知,以便增加预留大小。您可以随时更新预留的吞吐量。 更改将在一分钟内生效。但是,如果您减少了预留的吞吐量,您仍然需要支付 24 小时内的较高金额。Pub/Sub Lite 本质上是按容量付费的系统,其中纵向扩容可即时完成,并且可以进行纵向缩容。
附加到精简版预留的所有精简版主题均使用同一吞吐量容量池。因此,精简版主题可能会突然使用大量的吞吐量容量,导致其他精简版主题出现资源匮乏,并阻止它们发布或接收消息。如果您需要在精简版主题之间实现完全隔离,可以将它们附加到独立的预留。
分区对精简版预留的影响
精简版预留中所有精简版主题的分区总数不得超过预留的容量单元数。例如,您不能将一个具有 10 个容量单元的精简版预留附加到一个精简版主题或一组分区总数大于 10 的精简版主题。
计算精简版预留的容量单位
精简版预留的大小由容量单元数定义。以下示例说明了如何估算各个精简版主题所需的容量。
确定发布吞吐量峰值。
估算附加到精简版预留的所有精简版主题的吞吐量峰值。粗略估计的吞吐量就足够了,因为您始终可以更新预留的大小。
确定订阅吞吐量峰值。
订阅吞吐量峰值的计算方法类似于发布吞吐量峰值。但请注意,您的订阅者不一定需要以发布者的峰值速率接收消息。如果处理延迟在可接受范围内,Pub/Sub Lite 可让您缓冲消息并以稳定的速率进行处理。同时,您可能希望拥有比发布容量更多的订阅容量,以应对订阅者偶尔停机的情况。
确定所需的容量单元的总数。
上一部分中的表指定了容量单元可以为不同操作容纳的 MiBps 数。以下公式用于计算示例精简版预留所需的容量单位:
- 可用区级精简版主题的发布吞吐量峰值 =
Pz MiBps
- 区域级精简版主题的峰值发布吞吐量 =
Pr MiBps
- 可用区级精简版主题的订阅吞吐量峰值 =
Sz MiBps
区域级精简版主题的峰值订阅吞吐量 =
Sr MiBps
所需的容量单位数 =
(Pz / 1 MiBps) + (Pr/0.25 MiBps) + (Sz/2 MiBps) + (Sr/0.5 MiBps)
如果数值不是整数,则必须向上舍入。
- 可用区级精简版主题的发布吞吐量峰值 =
在没有精简版预留的情况下配置吞吐量容量
主题发布吞吐量容量:您可以指定 4 到 16 MiB 的吞吐量容量,且值必须为整数。
主题订阅吞吐量容量:您可以指定 4 到 32 MiB 的吞吐量容量,且值必须为整数。
对于订阅吞吐量,我们建议您将吞吐量容量预配为预期发布吞吐量与主题的订阅数的乘积。
为单个主题预配的发布者和订阅者容量不可互换。处于这个原因,我们建议始终使用预留。
直接为主题预配容量而不是使用预留时,结算会存在差异。如需了解详情,请参阅 Pub/Sub 精简版价格页面。
创建精简版预留
精简版预留必须与关联到它的任何精简版主题位于同一项目和区域中。如需查看可用地区和区域的列表,请参阅 Pub/Sub 精简版位置。
您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Pub/Sub Lite API 创建精简版预留。
控制台
转到精简版预留页面。
点击创建精简版预留。
请选择区域。
输入精简版预留 ID。
预配吞吐量容量单位的数量。
点击创建。
gcloud
要创建精简版预留,请使用 gcloud pubsub lite-reservations create
命令:
gcloud pubsub lite-reservations create myRes \ --location=us-central1 \ --throughput-capacity=INTEGER_NUMBER_OF_UNITS
gcloud pubsub lite-topics create myTopic \ --throughput-reservation=myRez \ --zone=ZONE \ --location=us-central1a \ --partitions \ --storage
Go
在运行此示例之前,请按照 Pub/Sub 精简版客户端库中的 Go 设置说明进行操作。
Java
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Java 设置说明进行操作。
Python
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Python 设置说明进行操作。
更新精简版预留
您可以更新为精简版预留配置的容量单元数。
您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Pub/Sub Lite API 更新精简版预留。
控制台
转到精简版预留页面。
点击精简版预留 ID。
在精简版订阅详情页面中,点击修改。
gcloud
要更新精简版预留,请使用 gcloud pubsub lite-reservations update
命令:
gcloud pubsub lite-reservations update RESERVATION_ID \ --location=REGION \ --throughput-capacity=THROUGHPUT_CAPACITY
请替换以下内容:
- RESERVATION_ID:精简版预留的 ID
- REGION:预留的区域
- THROUGHPUT_CAPACITY:预留吞吐量容量。
Go
在运行此示例之前,请按照 Pub/Sub 精简版客户端库中的 Go 设置说明进行操作。
Java
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Java 设置说明进行操作。
Python
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Python 设置说明进行操作。
获取精简版预留详情
您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Pub/Sub Lite API 获取有关精简版预留的详细信息。
控制台
转到精简版预留页面。
点击精简版预留 ID。
gcloud
要获取精简版预留的详细信息,请使用 gcloud pubsub lite-reservations describe
命令:
gcloud pubsub lite-reservations describe RESERVATION_ID \ --location=REGION
请替换以下内容:
- RESERVATION_ID:精简版预留的 ID
- REGION:预留的区域
Go
在运行此示例之前,请按照 Pub/Sub 精简版客户端库中的 Go 设置说明进行操作。
Java
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Java 设置说明进行操作。
Python
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Python 设置说明进行操作。
列出精简版预留
控制台
转到精简版预留页面。
gcloud
要查看项目中的精简版预留列表,请使用 gcloud pubsub lite-reservations list
命令:
gcloud pubsub lite-reservations list \ --location=REGION
请替换以下内容:
- REGION:预留的区域
Go
在运行此示例之前,请按照 Pub/Sub 精简版客户端库中的 Go 设置说明进行操作。
Java
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Java 设置说明进行操作。
Python
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Python 设置说明进行操作。
删除精简版预留
您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Pub/Sub Lite API 删除精简版预留。如需删除预留,预留不得包含任何主题。您可以将现有主题关联到其他预留,然后再删除预留。
控制台
转到精简版预留页面。
点击精简版预留 ID。
在精简版预留详情页面中,点击删除。
在显示的对话框中,点击删除以确认您要删除精简版预留。
gcloud
要删除精简版预留,请使用 gcloud pubsub lite-reservations delete
命令:
gcloud pubsub lite-reservations delete RESERVATION_ID \ --location=REGION
请替换以下内容:
- RESERVATION_ID:精简版预留的 ID
- REGION:预留的区域
Go
在运行此示例之前,请按照 Pub/Sub 精简版客户端库中的 Go 设置说明进行操作。
Java
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Java 设置说明进行操作。
Python
在运行此示例之前,请按照 Pub/Sub Lite 客户端库中的 Python 设置说明进行操作。
后续步骤
- 了解 Pub/Sub Lite 价格。
- 创建精简版主题。