Используйте обозреватель Service Bus для выполнения операций с данными в Service Bus.

Служебная шина Azure позволяет клиентам-отправителям и клиентам-получателям отделить свою бизнес-логику с помощью привычной семантики "точка-точка" (очередь) и "публикация-подписка" (тема-подписка).

Операции, выполняемые в пространстве имен Azure Service Bus, бывают двух видов.

• Операции управления - создание, обновление, удаление пространства имен шины служб, очередей, тем и подписок.
• Операции с данными: отправка и получение сообщений в очередях, разделах и подписках.

Предварительные условия

Чтобы использовать средство обозревателя Service Bus, необходимо выполнить следующие задачи:

• Создайте пространство имен Служебной шины Azure.

• Создайте очередь для отправки и получения сообщений или тему с подпиской, чтобы проверить функциональность. Чтобы узнать, как создавать очереди, темы и подписки, ознакомьтесь с указанными ниже статьями.

  • Быстрый старт — Создание очередей
  • Быстрый старт - Создание тем

  Примечание.

  Убедитесь, что вы являетесь членом одной из этих ролей в пространстве имен или сущностях, в которых вы хотите выполнить операции отправки или получения (включая просмотр и очистку).

  • владелец данных служебной шины; Разрешает выполнять операции отправки и получения.
  • служебная шина передачи данных; Позволяет выполнять операции отправки.
  • служебная шина приемник данных; Разрешает операции получения.

Использование Service Bus Explorer

Чтобы использовать Service Bus Explorer, перейдите в пространство имен Служебной шины, в котором вы хотите выполнять операции с данными.

1. Если вы хотите выполнить операции с очередью, выберите Очереди в меню навигации. Если вы хотите выполнить операции с темой (и ее связанными подписками), выберите Темы.

   

2. Выбрав раздел Очереди или Разделы, выберите конкретную очередь или раздел.

   

3. Выберите Обозреватель службы шины из меню навигации слева

   

   Примечание.

   При просмотре или получении из подписки сначала выберите конкретную подписку в выпадающем списке.

   Примечание.

   При переходе в обозреватель Service Bus для объекта в пространстве имен с отключенным публичным доступом вы увидите следующее сообщение, даже если вы обращаетесь к ней с виртуальной машины, которая находится в той же виртуальной сети, что и у частной конечной точки. Его можно пропустить.

   Пространство имён имеет отключённый доступ к общедоступной сети. Операции с данными, такие как просмотр, отправка или получение, для этой сущности Service Bus не работают, пока вы не переключитесь на все сети или не добавите IP-адрес вашего клиента в список разрешенных в выбранных сетях.

Просмотр сообщения

С помощью функции просмотра можно использовать обозреватель служебная шина для просмотра первых 100 сообщений в очереди, подписке или очереди недоставленных писем.

1. Для просмотра сообщений выберите Режим просмотра в раскрывающемся списке Service Bus Explorer.

   

2. Проверьте метрики, чтобы узнать, есть ли активные сообщения или недоставленные сообщения, чтобы просмотреть и выбрать вложенный запрос Queue/ Subscription или DeadLetter.

   

3. Нажмите кнопку Показать с начала.

   

4. После завершения операции просмотра до 100 сообщений отображаются в сетке, как показано на следующем рисунке. Чтобы просмотреть подробные сведения о конкретном сообщении, выберите его в сетке. Вы можете просмотреть текст или свойства сообщения.

   

   Перейдите на вкладку "Свойства сообщения" в нижней области, чтобы просмотреть метаданные.

   

   Примечание.

   Так как просмотр не является разрушительной операцией, сообщение не будет удалено из сущности.

   Примечание.

   По соображениям производительности при просмотре сообщений из очереди или подписки с максимальным размером сообщения, установленным более 1 МБ, текст сообщения по умолчанию не извлекается. Вместо этого вы можете загрузить текст определенного сообщения, нажав кнопку Load message body (Загрузить текст сообщения). Если текст сообщения превышает 1 МБ, он не усечен перед отображением.

Просмотр сообщения с дополнительными параметрами

Функциональность "просмотр с параметрами" позволяет использовать Обозреватель служебной шины для просмотра первых сообщений в очереди, подписке или очереди недоставленных сообщений, указав количество сообщений для просмотра и порядковый номер, с которого начать операцию просмотра.

1. Для просмотра сообщений с расширенными параметрами выберите Режим просмотра в раскрывающемся списке Service Bus Explorer.

   

2. Проверьте метрики, чтобы узнать, есть ли активные сообщения или недоставленные сообщения, чтобы просмотреть и выбрать вложенный запрос Queue/ Subscription или DeadLetter.

   

3. Нажмите кнопку Просмотреть с параметрами. Укажите количество сообщений для просмотра и порядковый номер, с которого нужно начать просмотр, а затем нажмите кнопку Просмотреть.

   

4. После завершения операции просмотра сообщения отображаются в сетке, как показано на следующем рисунке. Чтобы просмотреть подробные сведения о конкретном сообщении, выберите его в сетке. Вы можете просмотреть текст или свойства сообщения.

   

   Перейдите на вкладку "Свойства сообщения" в нижней области, чтобы просмотреть метаданные.

   

   Примечание.

   Так как просмотр не является разрушительной операцией, сообщение не будет удалено из очереди.

Получение сообщения

Функция получения в Service Bus Explorer позволяет получать сообщения из очереди или подписки.

1. Чтобы получить сообщения, выберите Режим получения в раскрывающемся списке Service Bus Explorer.

   

2. Проверьте метрики, чтобы выяснить, доступны ли для получения активные сообщения или сообщения, помещенные в очереди недоставленных, и выберите либо очередь/подписку, либо DeadLetter.

   

3. Нажмите кнопку "Получение сообщений" и укажите режим получения, количество полученных сообщений и максимальное время ожидания сообщения и нажмите кнопку "Получение".

   

   Внимание

   Режим ReceiveAndDelete является разрушающим получением, то есть сообщение удаляется из очереди, когда оно отображается в инструменте Service Bus Explorer.

   Чтобы просмотреть сообщения, не удаляя их из очереди, рассмотрите возможность использования функции Просмотр или режима получения PeekLock.

4. После завершения операции получения сообщения отображаются в сетке, как показано на следующем рисунке. Чтобы просмотреть подробные сведения о конкретном сообщении, выберите его в сетке.

   

   

   Примечание.

   По соображениям производительности при получении сообщений из очереди или подписки с максимальным размером сообщения, заданным более 1 МБ, за один раз получается только одно сообщение. Если текст сообщения превышает 1 МБ, он усечен перед отображением.

После получения сообщения в режиме PeekLock можно выполнить различные действия.

Завершение сообщения

1. В сетке выберите полученные сообщения, которые вы хотите завершить.

2. Нажмите кнопку Завершить.

   

   Внимание

   Завершение сообщения является «разрушающим получением»destructive receive, то есть сообщение удаляется из очереди при выборе Complete в средстве обозревателя Service Bus Explorer.

Откладывание сообщения

1. В сетке выберите одно или несколько полученных сообщений, которые нужно отложить.

2. Нажмите кнопку Отложить.

   

Отключить блокировку

1. В сетке выберите одно или несколько полученных сообщений, для которых нужно отказаться от блокировки.

2. Нажмите кнопку Отказаться от блокировки.

   

После снятия блокировки сообщение снова будет доступно для операций получения.

Недоставленные сообщения

1. В сетке выберите одно или несколько полученных сообщений, которые вы хотите перенести в очередь неудачных сообщений.

2. Нажмите кнопку Неразосланные.

   

После того как сообщение попадает в очередь мёртвых писем, оно доступно из подочереди мёртвых писем.

Очистка сообщений

Чтобы очистить сообщения, нажмите кнопку «Очистить сообщения» в обозревателе службы шины.

После ввода "очистка" для подтверждения операции сообщения будут удалены из соответствующей системной шины.

Отправка сообщения в очередь или раздел

Чтобы отправить сообщение в очередь или раздел, нажмите кнопку Отправить сообщения в окне Service Bus Explorer.

1. Задайте для параметра Тип содержимого значение Text/Plain, Application/Xml или Application/Json.

2. В поле Текст сообщения введите содержимое сообщения. Убедитесь, что оно соответствует заданному ранее полю Тип содержимого.

3. Задайте свойства брокера (необязательно). К этим свойствам относятся идентификатор корреляции, идентификатор сообщения, replyTo, Label/Subject, Time to Live (TTL) и Scheduled Enqueue Time (for Scheduled Message).

4. Задайте настраиваемые свойства (необязательно). Эти свойства могут быть любым пользовательским свойством, заданным для ключа словаря.

5. Щелкните Повторить отправку, чтобы отправить одно и то же сообщение несколько раз. Если идентификатор сообщения не задан, он автоматически заполняется последовательными значениями.

6. После создания сообщения нажмите кнопку "Отправить ".

   

7. После успешного завершения операции отправки происходит одно из следующих изменений:

   • При отправке в очередь счетчик метрик "Активные сообщения" увеличивается.
   • При отправке в тему счетчик метрик "Активные сообщения" увеличивается для подписок, куда было направлено сообщение.

Повторно отправить сообщение

После просмотра или получения сообщения вы можете повторно отправить его, отправляя копию сообщения в ту же сущность, позволяя нам обновлять его содержимое и свойства. Оригинальный элемент остается и не удаляется даже при повторной отправке из очереди недоставленных сообщений.

1. В сетке выберите одно или несколько сообщений, которые нужно повторно отправить.

2. Нажмите кнопку Повторно отправить выбранные сообщения.

   

3. При необходимости выберите любое сообщение, для которого нужно обновить сведения и внести необходимые изменения.

4. Нажмите кнопку Отправить, чтобы отправить сообщения в сущность.

   

   Примечание.

   • Операция повторной отправки отправляет копию исходного сообщения. Он не удаляет исходное сообщение, которое вы отправляете снова.
   • При повторной отправке сообщения в очередь недоставленных сообщений подписки копия сообщения отправляется в раздел. Поэтому все подписки получают копию сообщения.

Переключение типа проверки подлинности

При работе с обозревателем служебной шины можно использовать аутентификацию с помощью ключа доступа или идентификатора Microsoft Entra ID.

1. Нажмите кнопку Параметры.

   

2. Выберите нужный метод проверки подлинности и нажмите кнопку Сохранить.

   

Следующие шаги

• Ознакомьтесь с дополнительными сведениями об очередях и разделах Служебной шины Azure.
• Ознакомьтесь с дополнительными сведениями о создании очередей Служебной шины Azure с помощью портала Azure.
• Узнайте больше о создании тем и подписок в Служебной шине Azure через портал Azure.