Compartilhar via

使用“Service Bus Explorer”工具对 Service Bus 进行数据操作。

Azure Service Bus使发送方和接收方客户端应用程序能够使用熟悉的点到点（队列）和发布-订阅（Topic-Subscription）语义来分离其业务逻辑。

注意

本文重点介绍属于Azure门户的Azure Service Bus资源管理器的功能。

社区拥有的开源Service Bus Explorer是一个独立的应用程序，与这个应用程序不同。

可以在 Azure Service Bus 命名空间上运行两种类型的操作。

  • 管理操作 - 创建、更新和删除 Service Bus 命名空间、队列、主题和订阅。
  • 数据操作 - 向/从队列、主题和订阅发送/接收消息。

重要

  • Service Bus Explorer 不支持 管理操作和 会话。
  • 不要将Service Bus资源管理器用于较大的消息，因为它可能会导致超时，具体取决于消息大小、客户端与Service Bus服务之间的网络延迟，以及其他因素。 请改用自己的客户端来处理较大的消息，你可以在其中指定自己的超时值。
  • 如果只能通过专用终结点访问 Service Bus 命名空间，则您必须在带有专用终结点的虚拟网络内主机上运行 Web 浏览器。 此外，请确保没有网络安全组（NSG）阻止访问。
  • 如果用户仅有权访问实体，而没有命名空间，那么在涉及迁移到高级层或元数据灾难恢复的情况下，Service Bus 资源管理器可能无法按预期工作。

先决条件

若要使用Service Bus资源管理器工具，请完成以下任务：

使用Service Bus Explorer

若要使用Service Bus资源管理器，请前往要在其中执行数据操作的Service Bus命名空间。

  1. 如果要对队列运行作，请从导航菜单中选择 “队列 ”。 如果要针对主题（及其相关订阅）运行作，请选择 “主题”。

    左侧导航栏的屏幕截图，用户可以在其中选择实体。

  2. 选择“队列”或“主题”后，选择特定的队列或主题。

    屏幕截图显示“队列”页面，其中显示某个队列处于选中状态。

  3. 从左侧导航菜单中选择 Service Bus Explorer。

    队列页面的截图，其中可以选择Service Bus资源管理器。

    注意

    要从订阅中速览或接收消息时，请先从下拉列表选择器中选择特定的订阅。 主题订阅的下拉列表的屏幕截图。

    注意

    导航到命名空间中禁用公共访问权限的实体的Service Bus资源管理器时，即使从与专用终结点位于同一虚拟网络中的虚拟机访问它，也会看到以下消息。 可将其忽略。

    “命名空间已禁用公用网络访问。 若要在此 Service Bus 实体上执行“查看”、“发送”或“接收”这类数据操作，需切换到所有网络或在所选网络中将您的客户端 IP 列入允许列表。

扫视消息

通过使用速览功能，可以使用Service Bus资源管理器查看队列、订阅或死信队列中的前 100 条消息。

  1. 在 Service Bus Explorer 下拉列表中选择窥视模式以窥视消息。

    下拉列表的屏幕截图，其中选择了“速览模式”。

  2. 检查指标以查看是否存在可一瞥的 活动消息 或 死信消息。 选择 队列/订阅 或 DeadLetter 子队列。

    队列和死信子队列选项卡的屏幕截图，其中显示了消息指标。

  3. 选择“从头开始速览”按钮。

    显示“从头开始速览”按钮的屏幕截图。

  4. 当窥视操作完成后，网格上最多会显示 100 条消息。 若要查看特定消息的详细信息，请在网格中选择该消息。 可以选择查看正文或消息属性。

    该屏幕截图显示了预览消息的概述以及消息正文内容。

    切换到底部窗格中的“消息属性”选项卡以查看元数据。

    屏幕截图提供了速览消息的概述，并显示了这些速览消息的属性。

    注意

    由于速览不是破坏性操作，因此 不会 从实体中删除消息。

    注意

    出于性能原因，从队列或订阅中查看其最大消息大小设置为超过 1 MB 的消息时，默认情况下不会检索消息正文。 相反，可以通过选择 “加载消息正文 ”按钮来加载特定邮件的消息正文。 如果消息正文超过 1MB，它不会在显示之前被截断。 该屏幕截图显示了速览消息的概述以及用于加载消息正文的按钮。

使用高级选项查看消息

通过使用“选项速览”功能，可以使用“Service Bus 资源管理器”查看队列、订阅或死信队列中的首条消息。 可以指定要查看的消息数量和用于启动查看操作的序列号。

  1. 若要使用高级选项查看消息，请在“Service Bus资源管理器”下拉列表中选择Peek Mode。

    下拉列表的屏幕截图，其中为使用高级选项的速览选择了“速览模式”。

  2. 检查指标以查看是否存在可一瞥的 活动消息 或 死信消息。 选择 队列/订阅 或 DeadLetter 子队列。

    队列和死信子队列选项卡的屏幕截图，其中显示了可速览的消息指标和高级选项。

  3. 选择“带选项的速览”按钮。 输入要查看的消息数以及要从中开始查看的序列号。 选择 “速览 ”按钮。

    屏幕截图显示了“速览”和选项按钮，并显示了可设置选项的页面。

  4. 操作完成后，消息将显示在网格中，如下图所示。 若要查看特定消息的详细信息，请在网格中选择该消息。 可以选择查看正文或消息属性。

    该屏幕截图显示了速览消息的概述，以及在使用高级选项时速览的消息正文内容。

    切换到底部窗格中的“消息属性”选项卡以查看元数据。

    该屏幕截图显示了速览消息的概述，以及使用高级选项的速览的消息属性。

    注意

    由于速览不是破坏性操作，因此消息不会从队列中删除。

接收消息

Service Bus资源管理器的接收功能允许从队列或订阅接收消息。

  1. 若要接收消息，请在Service Bus资源管理器下拉列表中选择Receive Mode。

    下拉列表的屏幕截图，其中选择了“接收模式”。

  2. 检查指标以确认是否有“活动消息”或“死信消息”供接收，然后选择“队列/订阅”或“死信”。

    队列和死信子队列选项卡的屏幕截图，其中显示了接收模式的消息指标。

  3. 选择 “接收消息 ”按钮，并指定接收模式、要接收的消息数以及等待消息的最大时间，然后选择“ 接收”。

    屏幕截图显示了“接收”按钮，并显示了可设置选项的页面。

    重要

    ReceiveAndDelete 模式是一种 破坏性接收，即消息在 Service Bus Explorer 工具中显示时会从队列中删除。

    若要浏览消息而不将其从队列中删除，请考虑使用“速览”功能，或使用“PeekLock”接收模式。

  4. 接收操作完成后，网格中显示了消息，如下图所示。 若要查看特定消息的详细信息，请在网格中选择该消息。

    该屏幕截图显示了接收的消息的概述和消息正文内容。

    该屏幕截图显示了接收的消息的概述和消息属性。

    注意

    出于性能原因，从队列或订阅接收消息时，其最大消息大小设置为超过 1 MB 时，一次只接收一条消息。 如果消息正文超过 1 MB，则工具在显示之前将其截断。

在“PeekLock”模式下接收消息后，可以对其执行各种操作。

注意

只有在锁定消息的情况下才能执行这些操作。

完成撰写消息

  1. 在网格中，选择需要处理的已接收消息。

  2. 选择“完成”按钮。

    该屏幕截图指示了“完成”按钮。

    重要

    完成消息后，将执行 破坏性接收。 在Service Bus资源管理器工具中选择Complete后，该过程将从队列中删除消息。

推迟处理消息

  1. 在网格中，选择一个或多个要推迟的已接收消息。

  2. 选择延迟按钮。

    该屏幕截图指示了“延迟”按钮。

放弃锁定

  1. 在网格中，选择一个或多个你想解除锁定的已接收消息。

  2. 选择“放弃锁定”按钮。

    该屏幕截图指示了“放弃锁定”按钮。

放弃锁定后，该消息可再次用于接收操作。

死信

  1. 在网格中，选择要死信的一个或多个已接收的消息。

  2. 选择“死信”按钮。

    显示“死信”按钮的屏幕截图。

完成死信操作后，您可以从 死信 子队列中访问该消息。

清除消息

若要清除消息，请在Service Bus资源管理器中选择 Purge messages 按钮。

指示清除消息按钮的屏幕截图。

出现提示时，输入“清除”以确认操作。 该过程从相应的服务总线实体中清除消息。

向队列或主题发送消息

若要将消息发送到 queue 或 topic，请在Service Bus资源管理器中选择 Send messages 按钮。

  1. 选择内容类型为Text/Plain、Application/Xml 或Application/Json。

  2. 对于“消息正文”，请添加消息内容。 请确保它与之前设置的 内容类型 匹配。

  3. 设置“代理属性”（可选）。 这些属性包括关联 ID、消息 ID、ReplyTo、标签/主题、存活时间 (TTL) 和计划排队时间（对于计划消息）。

  4. 设置自定义属性（可选）。 这些属性可以是针对字典键设置的任何用户属性。

  5. 选中“重复发送”以多次发送同一条消息。 如果未设置消息 ID，进程会自动使用顺序值填充它。

  6. 撰写完邮件后，选择“ 发送”。

    显示撰写消息体验的屏幕截图。

  7. 发送作成功完成后，会发生以下更改之一：

    • 如果要发送到队列，进程会递增 活动消息 指标计数器。
    • 如果要发送到某个主题，则进程会对消息所路由到的订阅上的 活动消息 指标计数器进行递增。

重新发送消息

查看或接收消息后，可以重新发送它。 重新发送会将消息的副本发送到同一实体，同时允许更新其内容和属性。 即使从死信队列重新发送，原始消息也会保留，也不会被删除。

  1. 在网格中，选择要重新发送的一个或多个消息。

  2. 选择“重新发送所选消息”按钮。

    屏幕截图显示了“重新发送所选消息”按钮。

  3. （可选）选择你想要更新其详细信息的任何消息并进行所需的更改。

  4. 选择“发送”按钮将消息发送到实体。

    屏幕截图显示了重新发送消息体验。

    注意

    • 重新发送操作会发送原始消息的副本。 它不会删除你重新提交的原始邮件。
    • 如果重新发送订阅的死信队列中的消息，该消息的副本将发送到相应主题。 因此，所有订阅都会收到该消息的副本。

导出消息

可以通过选择工具栏上的 “导出邮件 ”按钮，将网格中的邮件导出到 Excel 工作表。

显示导出消息体验的屏幕截图。

显示或隐藏消息正文

在网格中选择消息时，消息正文默认显示在底部窗格中。 若要隐藏邮件正文，请选择工具栏上的 “隐藏邮件正文 ”。 然后，选择“ 速览 ”或 “接收 ”以加载不带正文的消息。 当实体中存在大型消息时，此选项非常有用。 它不会在底部窗格中切换邮件正文选项卡（如果已打开）。

指示“隐藏消息正文”按钮的屏幕截图。

切换身份验证类型

使用 Service Bus 资源管理器时，可以使用 Access Key 或 Microsoft Entra ID 身份验证。

  1. 选择“设置”按钮。

    <sb0>显示 Service Bus Explorer 中“设置”按钮的截图。</sb0>

  2. 选择要使用的身份验证方法，然后选择“ 保存”。

    屏幕截图显示了“设置”按钮，以及显示不同身份验证类型的页面。

后续步骤

  • Last updated on