Добавление сообщений в очередь службы хранилища Azure с помощью Функций
В службе "Функции Azure" входные и выходные привязки предоставляют декларативный способ предоставления коду данных внешних служб. В этом кратком руководстве используется выходная привязка для создания сообщения в очереди при активации функции HTTP-запросом. Используйте контейнер службы хранилища Azure для просмотра сообщений очереди, создаваемых вашей функцией.
Предварительные требования
Для работы с этим кратким руководством сделайте следующее:
Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начать работу.
Следуйте указаниям, приведенным в статье Создание первой функции на портале Azure, пропустив шаг Очистка ресурсов. При работе с этим кратким руководством создаются приложение-функция и функция, которые вы будете использовать здесь.
Добавление выходной привязки
В этом разделе вам нужно будет добавить выходную привязку хранилища очередей для функции, созданной ранее, с помощью пользовательского интерфейса портала. Эта привязка позволяет написать минимальный код для создания сообщения в очереди. Вам не нужно писать код для таких задач, как открытие подключения к хранилищу, создание очереди или получение ссылки на очередь. Эти задачи выполняет среда выполнения службы "Функции Azure" и выходная привязка очереди.
На портале Azure откройте страницу приложения-функции для приложения, созданного ранее. Чтобы открыть страницу, найдите и выберите Приложение-функция. Затем выберите свое приложение-функцию.
Выберите приложение-функцию, а затем выберите созданную ранее функцию.
Последовательно выберите Интеграция и + Добавить вывод.
Выберите тип привязки Хранилище очередей Azure и добавьте параметры, указанные в следующей таблице:
Параметр Рекомендуемое значение Описание Имя параметра сообщения outputQueueItem Имя параметра выходной привязки. Имя очереди outqueue Имя очереди для подключения к вашей учетной записи хранения. Подключение к учетной записи хранения AzureWebJobsStorage Вы можете использовать подключение к учетной записи хранения, которое уже используется вашим приложением-функцией, или создать его. Щелкните OK, чтобы добавить привязку.
Теперь, когда выходная привязка определена, вам нужно обновить код, чтобы использовать привязку для добавления сообщений в очередь.
Добавление кода, который использует выходную привязку
В этом разделе вы добавляете код, который записывает сообщение в выходную очередь. Сообщение содержит значение, которое передается в триггер HTTP в строке запроса. Например, если строка запроса содержит name=Azure
, в сообщении очереди будет указано: Имя передано функции: Azure.
В функции выберите Код + тест для отображения кода функции в редакторе.
Измените код функции в соответствии с ее языком.
Добавьте параметр outputQueueItem в сигнатуру метода, как показано в следующем примере.
public static async Task<IActionResult> Run(HttpRequest req, ICollector<string> outputQueueItem, ILogger log) { ... }
В теле функции непосредственно перед инструкцией
return
добавьте код, который создает сообщение очереди с помощью этого параметра.outputQueueItem.Add("Name passed to the function: " + name);
Щелкните Сохранить, чтобы сохранить изменения.
Проверка функции
Сохранив изменения в коде, щелкните Тест.
Убедитесь, что тест соответствует приведенному ниже изображению, и выберите Запустить.
Обратите внимание, что тело запроса содержит
name
значение Azure. Это значение находится в сообщении очереди, которое создается при вызове функции.Кроме выбора элемента Запуск можно вызвать функцию, введя URL-адрес в браузере и указав значение
name
в строке запроса. Метод браузера описан в предыдущем кратком руководстве.Проверьте журналы, чтобы убедиться, что функция успешно выполнена.
Новая очередь с именем outqueue создается в вашей учетной записи хранения средой выполнения Функции при первом использовании выходной привязки. Чтобы убедиться, что очередь и сообщение в ней были созданы, вам нужно будет использовать учетную запись хранения.
Найдите учетную запись хранения, подключенную к AzureWebJobsStorage.
Перейдите к приложению-функции и выберите Конфигурация.
В разделе Параметры приложения выберите AzureWebJobsStorage.
Найдите и запишите имя учетной записи.
Проверка выходной очереди
В группе ресурсов для приложения-функции выберите используемую учетную запись хранения.
В разделе Служба очередей нажмите Очереди и выберите очередь outqueue.
В ней содержится сообщение о том, что выходная привязка очереди создана при запуске функции, активируемой HTTP. Если вы вызывали функцию со значением по умолчанию
name
Azure, в сообщении очереди будет указано Имя переданной функции: Azure.Запустите функцию еще раз, и в очереди появится новое сообщение.
Очистка ресурсов
Другие краткие руководства в этой коллекции созданы на основе этого документа. Если вы планируете работать с последующими руководствами или краткими руководствами, а также или любыми службами, созданными при работе с этим руководством, не очищайте ресурсы.
Под ресурсами в Azure подразумеваются приложения-функции, функции, учетные записи хранения и т. д. Они объединяются в группы ресурсов, при удалении которых удаляются и все данные в них.
Вы создали ресурсы для завершения этих кратких руководств. За эти ресурсы могут выставляться счета в зависимости от состояния учетной записи и цен на службы. Если вам больше не нужны ресурсы, их можно удалить следующим образом:
На портале Azure перейдите на страницу Resource group (Группа ресурсов).
Чтобы перейти на эту страницу со страницы приложения-функции, перейдите на вкладку Обзор,и щелкните ссылку в разделе Группа ресурсов.
Чтобы перейти на эту страницу с панели управления, выберите Resource groups (Группы ресурсов), а затем выберите группу ресурсов, которая использовалась в этой статье.
На странице Группа ресурсов просмотрите список включенных ресурсов и убедитесь, что именно их нужно удалить.
Выберите Удалить группу ресурсов и следуйте инструкциям.
Удаление может занять несколько минут. После этого на несколько секунд появится уведомление. Кроме того, можно выбрать значок колокольчика в верхней части страницы, чтобы просмотреть уведомление.
Дальнейшие действия
Выполнив указания этого краткого руководства, вы добавили выходную привязку в имеющуюся функцию. Дополнительные сведения о привязках к хранилищу очередей см.в статье Привязки очередей службы хранилища для Функций Azure.
- Основные понятия. Триггеры и привязки в функциях Azure
Узнайте, как решение "Функции Azure" интегрируется с другими службами. - Справочник разработчика по функциям Azure
Дополнительные технические сведения о среде выполнения Функций Azure, а также справочник по программированию функций и определению триггеров и привязок. - Как программировать и тестировать функции Azure в локальной среде
Описание способов разработки функций в локальной среде.