通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

服务总线队列、主题和订阅

  • 项目

Azure 服务总线支持可靠消息队列和持久发布/订阅消息。 服务总线中构成消息传送功能核心的消息传送实体是队列、主题和订阅。

重要

如果你不熟悉 Azure 服务总线，请在通读本文之前通读什么是 Azure 服务总线？。

队列

队列为一个或多个竞争使用方提供先入先出 (FIFO) 消息传递方式。 也就是说，接收方通常会按照消息添加到队列中的顺序来接收并处理消息。 并且每条消息仅由一个消息使用方接收并处理。

此图显示服务队列工作原理。

使用队列的主要优点是实现应用程序组件的临时分离。 换而言之，由于消息持久存储在队列中，因此创建方（发送方）和使用方（接收方）不必同时发送和接收消息。 此外，创建方不必等待使用方的答复即可继续处理并发送更多消息。

相关的优点是“负载分级”，它允许创建方和使用方以不同速率发送和接收消息。 在许多应用程序中，系统负载随时间而变化。 但是，每个工作单元所需的处理时间通常为常量。 使用队列在消息创建方与使用方之间中继意味着，消费应用程序只需能够处理平均负载而非峰值负载。 队列深度将随传入负载的变化而加大和减小。 此功能会直接根据为应用程序负载提供服务所需的基础结构的数目来节省资金。 随着负载增加，可添加更多的工作进程以从队列中读取。 每条消息仅由一个辅助进程处理。 另外，可通过基于拉取的该负载均衡，以最合理的方式使用辅助计算机，即使具有处理能力的辅助计算机以其最大速率拉取消息也是如此。 此模式通常称为 使用者竞争 模式。

使用队列在消息创建方与使用方之间中继可在各组件之间提供固有的松散耦合。 由于创建方和使用方互不相识，因此，可升级使用方，而不会对创建方产生任何影响。

创建队列

可以使用下列选项之一创建队列：

然后，使用以编程语言编写的客户端发送和接收消息。编程语言包括以下语言：

接收模式

可以指定两种不同的可供使用者用来从服务总线接收消息的模式。

  • 接收并删除。 在此模式下，当服务总线收到来自使用者的请求时，它会将该消息标记为“正在使用”，并将其返回给使用者应用程序。 此模式是最简单的模型。 它最适合应用程序允许在出现故障时不处理消息的方案。 为了理解此方案，可以考虑这样一种情形：使用方发出接收请求，但在处理该请求前发生了崩溃。 由于服务总线将消息标记为“已使用”，因此应用程序会在重启后开始使用消息。 它会丢失在发生故障前使用的消息。 此过程通常称为“至多一次”处理。
  • 速览锁定。 在此模式下，接收操作分成了两步，从而有可能支持无法容忍遗漏消息的应用程序。

    1. 查找要使用的下一条消息，将其锁定以防其他使用者接收它，然后，将该消息返回到应用程序。

    2. 在应用程序处理完该消息后，它会请求服务总线服务完成接收过程的第二阶段。 然后，该服务将消息标记为“已使用”。

      如果应用程序出于某种原因无法处理该消息，它可以请求服务总线服务放弃 该消息。 服务总线会解锁该消息并使其能够再次被同一个使用者或其他竞争使用者接收。 其次，有一个与该锁定关联的超时。 如果应用程序无法在锁定超时期满前处理消息，服务总线会解锁消息，使其再次可供接收。

      如果应用程序在处理消息之后（但在请求服务总线服务完成该消息之前）崩溃，服务总线会在应用程序重启时将该消息重新传送到该应用程序。 此过程通常称为“至少一次”处理。 也就是说，每条消息至少处理一次。 但是，在某些情况下，同一消息可能会被重新传送。 如果方案不容许重复处理，请在应用程序中添加其他逻辑来检测重复项。 有关详细信息，请参阅重复检测，该检测称为“恰好一次”处理。

      注意

      有关这两种模式的详细信息，请参阅安排接收操作。

主题和订阅

队列允许单个使用方处理消息。 与队列不同，主题和订阅以“发布和订阅”模式提供一对多的通信形式。 这对于扩展到大量接收方而言十分有用。 每个发布的消息均可用于向该主题注册的每个订阅。 发布方将消息发送到主题，一个或多个订阅服务器将接收该消息的副本。

此图显示包含三个订阅的服务总线主题。

此订阅可以使用更多筛选器来限制其想要接收的消息。 发布方将消息发送到主题的方式与将消息发送到队列的方式相同。 但使用方不会直接从主题接收消息。 相反，使用方从该主题的订阅接收消息。 主题订阅类似于接收发送至该主题的消息副本的虚拟队列。 使用方从订阅接收消息的方式与从队列接收消息的方式相同。

队列的消息发送功能直接映射到主题，而其消息接收功能映射到订阅。 另外，此功能意味着订阅支持本部分前面所述的有关队列的相同模式：竞争使用者、临时分离、负载调节和负载均衡。

创建主题和订阅

创建主题与创建队列类似，如前一部分中所述。 可以使用下列选项之一创建主题和订阅：

然后，使用以编程语言编写的客户端将消息发送到主题并从订阅接收消息。编程语言包括以下语言：

规则和操作

在许多情况下，必须以不同方式处理具有特定特征的消息。 若要启用此处理，可配置订阅以找到具有所需属性的消息，并对这些属性执行某些修改。 虽然服务总线订阅可看到发送到主题的所有消息，但你只能将这些消息的一个子集复制到虚拟订阅队列。 可使用订阅筛选器完成此筛选。 此类修改称为筛选器操作 。 创建订阅后，你可以提供对消息属性进行操作的筛选表达式。 这些属性可以是系统属性（例如“标签”），也可以是自定义应用程序属性（例如“StoreName” 。）SQL 筛选器表达式在此示例中为可选。 如果没有 SQL 筛选器表达式，会对该订阅的所有消息执行在订阅上定义的任何筛选器操作。

有关完整的工作示例，请参阅 GitHub 上的 TopicFilters 示例。 有关筛选器的详细信息，请参阅主题筛选器和操作。

Java 消息服务 (JMS) 2.0 实体

以下实体可通过 Java 消息服务 (JMS) 2.0 API 进行访问。

  • 临时队列
  • 临时主题
  • 共享持久订阅
  • 非共享持久订阅
  • 共享非持久订阅
  • 非共享非持久订阅

详细了解 JMS 2.0 实体和如何使用它们。

快速实体

Express 实体专为高吞吐量和减少延迟的方案而创建。 使用 express 实体的话，如果向队列或主题发送消息，消息不会立即存储在消息存储区中。 相反，消息最初会缓存在内存中。 实体中保留的消息在延迟后写入到消息存储区中，此时这些消息会受到保护，以防止由于服务中断而丢失。

在常规实体中，任何运行时操作（如 Send、Complete、Abandon、Deadletter）将首先持久保存到存储区中，然后才向客户端确认操作成功。 在 express 实体中，运行时操作首先向客户端确认操作成功，然后才延迟持久保存到存储区中。 因此，如果计算机重新启动或发生硬件问题，某些已确认的运行时操作可能根本不会持久保存。 这意味着客户端可以通过 express 实体获得更低的延迟和更高的吞吐量，但代价是潜在的数据丢失和/或信息重新传递。

此外，随着时间的推移，服务总线内部也进行了许多优化，这意味着 express 实体的吞吐量和延迟优势目前是微乎其微。 此外，服务总线的高级层不支持 Express 实体。 因此，目前不建议使用此功能。

后续步骤

尝试使用所选语言的示例：

有关使用旧版 .NET 和 Java 客户端库的示例，请使用以下链接：

2026 年 9 月 30 日，我们将停用 Azure 服务总线 SDK 库 WindowsAzure.ServiceBus、Microsoft.Azure.ServiceBus 和 com.microsoft.azure.servicebus，这些库不符合 Azure SDK 准则。 我们还将结束对 SBMP 协议的支持，因此在 2026 年 9 月 30 日之后，你将无法再使用此协议。 请在该日期之前迁移到最新的 Azure SDK 库，新库提供了关键安全更新和改进功能。

尽管 2026 年 9 月 30 日之后仍然可以使用较旧的库，但它们将不再获得 Microsoft 的官方支持和更新。 有关详细信息，请参阅支持停用公告。