Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
160 lines (95 sloc) 15.1 KB
title description ms.assetid ms.topic ms.date ms.custom ms.openlocfilehash ms.sourcegitcommit ms.translationtype ms.contentlocale ms.lasthandoff ms.locfileid
Добавление сообщений в очередь службы хранилища Azure с помощью Функций
Создавайте независимые от сервера функции, активируемые HTTP-запросом и создающие сообщения в очереди службы хранилища Azure с помощью службы "Функции Azure".
0b609bc0-c264-4092-8e3e-0784dcc23b5d
quickstart
09/19/2017
mvc
fb5fc2fadf4087ebc42253cf568af424a80cb9d5
d6b68b907e5158b451239e4c09bb55eccb5fef89
HT
ru-RU
11/20/2019
74226885

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

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

Сообщение очереди в Обозревателе службы хранилища

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

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

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

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

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

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

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

  2. Выберите созданную ранее функцию.

  3. Выберите Интегрировать > Создать выходные данные > Хранилище очередей Azure.

  4. Нажмите кнопку Выбрать.

    Добавление выходной привязки хранилища очередей к функции на портале Azure.

  5. Если появится сообщение Расширения не установлены, щелкните Установить, чтобы установить в приложение-функцию расширение привязки Службы хранилища. Это может занять несколько минут.

    Установка расширения привязки Службы хранилища

  6. В разделе Azure Queue Storage output (Выходные данные хранилища очередей Azure) используйте параметры, указанные в следующей таблице:

    Добавление выходной привязки хранилища очередей к функции на портале Azure.

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

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

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

В этом разделе вы добавляете код, который записывает сообщение в выходную очередь. Сообщение содержит значение, которое передается в триггер 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.done.

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

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

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

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

    Добавление выходной привязки хранилища очередей к функции на портале Azure.

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

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

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

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

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

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

  1. Запустите инструмент Обозреватель службы хранилища Microsoft Azure, щелкните значок подключения слева, выберите Использовать имя и ключ учетной записи хранения, а затем щелкните Далее.

    Запуск инструмента "Обозреватель учетной записи хранения"

  2. На портале Azure на странице приложения-функции выберите свою функцию, а затем Интегрировать.

  3. Выберите выходную привязку Хранилище очередей Azure, добавленную ранее.

  4. В нижней части страницы разверните раздел Документация.

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

    Получение учетных данных для подключения к учетной записи хранения.

  5. Скопируйте значение имени учетной записи с портала и вставьте его в поле Имя учетной записи в Обозреватель службы хранилища.

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

  7. Выберите Далее > Подключить.

    Укажите учетные данные хранилища и подключитесь.

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

  1. В Обозревателе службы хранилища выберите используемую учетную запись хранения.

  2. Разверните узел Очереди, а затем выберите очередь с именем outqueue.

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

    Сообщение очереди в Обозревателе службы хранилища

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

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

[!INCLUDE Clean up resources]

Дополнительная информация

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

[!INCLUDE Next steps note]

You can’t perform that action at this time.