Добавление сообщений в очередь службы хранилища Azure с помощью Функций

В службе "Функции Azure" входные и выходные привязки предоставляют декларативный способ предоставления коду данных внешних служб. В этом кратком руководстве используется выходная привязка для создания сообщения в очереди при активации функции HTTP-запросом. Используйте контейнер службы хранилища Azure для просмотра сообщений очереди, создаваемых вашей функцией.

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

Для работы с этим кратким руководством сделайте следующее:

• Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начать работу.

• Следуйте указаниям, приведенным в статье Создание первой функции на портале Azure, пропустив шаг Очистка ресурсов. При работе с этим кратким руководством создаются приложение-функция и функция, которые вы будете использовать здесь.

Добавление выходной привязки

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

1. На портале Azure откройте страницу приложения-функции для приложения, созданного ранее. Чтобы открыть страницу, найдите и выберите Приложение-функция. Затем выберите свое приложение-функцию.

2. Выберите приложение-функцию, а затем выберите созданную ранее функцию.

3. Последовательно выберите Интеграция и + Добавить вывод.

   

4. Выберите тип привязки Хранилище очередей Azure и добавьте параметры, указанные в следующей таблице:

   

   Параметр	Рекомендуемое значение	Описание
   Имя параметра сообщения	outputQueueItem	Имя параметра выходной привязки.
   Имя очереди	outqueue	Имя очереди для подключения к вашей учетной записи хранения.
   Подключение к учетной записи хранения	AzureWebJobsStorage	Вы можете использовать подключение к учетной записи хранения, которое уже используется вашим приложением-функцией, или создать его.

5. Щелкните OK, чтобы добавить привязку.

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

Добавление кода, который использует выходную привязку

В этом разделе вы добавляете код, который записывает сообщение в выходную очередь. Сообщение содержит значение, которое передается в триггер HTTP в строке запроса. Например, если строка запроса содержит name=Azure, в сообщении очереди будет указано: Имя передано функции: Azure.

1. В функции выберите Код + тест для отображения кода функции в редакторе.

2. Измените код функции в соответствии с ее языком.

   C#

   Добавьте параметр outputQueueItem в сигнатуру метода, как показано в следующем примере.

   public static async Task<IActionResult> Run(HttpRequest req,
       ICollector<string> outputQueueItem, ILogger log)
   {
       ...
   }
   

   В теле функции непосредственно перед инструкцией return добавьте код, который создает сообщение очереди с помощью этого параметра.

   outputQueueItem.Add("Name passed to the function: " + name);
   

   JavaScript

   Добавьте код, который использует привязку для вывода в объекте context.bindings для создания сообщения очереди.

   context.bindings.outputQueueItem = "Name passed to the function: " + 
               (req.query.name || req.body.name);
   

3. Щелкните Сохранить, чтобы сохранить изменения.

Проверка функции

1. Сохранив изменения в коде, щелкните Тест.

2. Убедитесь, что тест соответствует приведенному ниже изображению, и выберите Запустить.

   

   Обратите внимание, что тело запроса содержит name значение Azure. Это значение находится в сообщении очереди, которое создается при вызове функции.

   Кроме выбора элемента Запуск можно вызвать функцию, введя URL-адрес в браузере и указав значение name в строке запроса. Метод браузера описан в предыдущем кратком руководстве.

3. Проверьте журналы, чтобы убедиться, что функция успешно выполнена.

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

Найдите учетную запись хранения, подключенную к AzureWebJobsStorage.

1. Перейдите к приложению-функции и выберите Конфигурация.

2. В разделе Параметры приложения выберите AzureWebJobsStorage.

   

3. Найдите и запишите имя учетной записи.

   

Проверка выходной очереди

1. В группе ресурсов для приложения-функции выберите используемую учетную запись хранения.

2. В разделе Служба очередей нажмите Очереди и выберите очередь outqueue.

   В ней содержится сообщение о том, что выходная привязка очереди создана при запуске функции, активируемой HTTP. Если вы вызывали функцию со значением по умолчанию nameAzure, в сообщении очереди будет указано Имя переданной функции: Azure.

3. Запустите функцию еще раз, и в очереди появится новое сообщение.

Очистка ресурсов

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

Под ресурсами в Azure подразумеваются приложения-функции, функции, учетные записи хранения и т. д. Они объединяются в группы ресурсов, при удалении которых удаляются и все данные в них.

Вы создали ресурсы для завершения этих кратких руководств. За эти ресурсы могут выставляться счета в зависимости от состояния учетной записи и цен на службы. Если вам больше не нужны ресурсы, их можно удалить следующим образом:

1. На портале Azure перейдите на страницу Resource group (Группа ресурсов).

   Чтобы перейти на эту страницу со страницы приложения-функции, перейдите на вкладку Обзор,и щелкните ссылку в разделе Группа ресурсов.

   

   Чтобы перейти на эту страницу с панели управления, выберите Resource groups (Группы ресурсов), а затем выберите группу ресурсов, которая использовалась в этой статье.

2. На странице Группа ресурсов просмотрите список включенных ресурсов и убедитесь, что именно их нужно удалить.

3. Выберите Удалить группу ресурсов и следуйте инструкциям.

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

Дальнейшие действия

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

• Основные понятия. Триггеры и привязки в функциях Azure
  Узнайте, как решение "Функции Azure" интегрируется с другими службами.
• Справочник разработчика по функциям Azure
  Дополнительные технические сведения о среде выполнения Функций Azure, а также справочник по программированию функций и определению триггеров и привязок.
• Как программировать и тестировать функции Azure в локальной среде
  Описание способов разработки функций в локальной среде.