Основные понятия триггеров и привязок в Функциях Azure

В этой статье вы узнаете о высокоуровневых понятиях, связанных с триггерами и привязками функций.

Триггеры — это причина запуска функции. Триггер определяет способ вызова функции, при этом функция должна иметь только один триггер. С триггерами связаны данные, которые обычно являются полезными данными функции.

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

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

Триггеры и привязки позволяют избежать жестко запрограммированного доступа к другим службам. Функция получает нужные данные (например, содержимое сообщения из очереди) в виде параметров. Вы отправляете данные (например, для создания в очереди сообщения) с использованием возвращаемого значения функции.

Рассмотрим следующие примеры реализации различных функций.

Пример сценария Триггер Входные привязки Выходные привязки
Поступает новое сообщение очереди, которое запускает функцию для записи в другую очередь. Очередь* Нет Очередь*
Запланированное задание считывает содержимое Хранилища BLOB-объектов и создает новый документ Cosmos DB. Таймер Хранилище BLOB-объектов Cosmos DB
Сетка событий используется для чтения изображения из Хранилища BLOB-объектов и документа из Cosmos DB для отправки сообщения электронной почты. Сетка событий Хранилище BLOB-объектов и Cosmos DB SendGrid
Веб-перехватчик использует Microsoft Graph для обновления листа Excel. HTTP Нет Microsoft Graph

* Представляет разные очереди

Эти примеры не являются исчерпывающими, но позволяют показать, как можно использовать триггеры и привязки вместе.

Определения триггеров и привязок

Триггеры и привязки определяются по-разному в зависимости от языка разработки.

Язык Триггеры и привязки настраиваются путем...
Библиотека классов C#      присвоения методов и параметров с помощью атрибутов C#
Java      присвоения методов и параметров с помощью примечаний Java
JavaScript/PowerShell/Python/TypeScript      обновления файла function.json (схема)

Для языков, которые используют function.json, портал предоставляет пользовательский интерфейс для добавления привязок на вкладке Интеграция. Вы также можете изменить файл непосредственно на портале на вкладке Код + тест функции. Visual Studio Code позволяет легко добавить привязку а файл function.json с помощью удобного набора запросов.

В .NET и Java тип параметра определяет тип входных данных. Например, используйте string для привязки к тексту триггера очереди, массив байтов — для чтения в двоичном формате и настраиваемый тип — для десериализации объекта. Так как функции библиотеки классов .NET и функции Java не используют function.json для определений привязки, их нельзя создать и изменить на портале. Функции редактирования C# на портале работают на основе скрипта C#, который использует файл function.json вместо атрибутов.

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

В языках с динамическим типированием, таких как JavaScript, используйте свойство dataType в файле function.json. Например, задайте для dataType значение binary, чтобы прочитать содержимое HTTP-запроса в двоичном формате.

{
    "dataType": "binary",
    "type": "httpTrigger",
    "name": "req",
    "direction": "in"
}

Другие варианты для dataType — stream и string.

Направление привязки

Все триггеры и привязки имеют свойство direction в файле function.json:

  • Для триггеров направление всегда входящее (in).
  • Для входных и выходных привязок используется как входящее (in), так и исходящее (out) направление.
  • Некоторые привязки поддерживают специальное направление inout. При использовании inout доступен только Расширенный редактор на вкладке портала Интегрировать.

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

Добавление привязок к функции

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

Поддерживаемые привязки

В этой таблице показаны привязки, которые поддерживаются в двух основных версиях среды выполнения Функций Azure.

Тип 1.x 2.x и выше1 Триггер Входные данные Выходные данные
Хранилище BLOB-объектов
Azure Cosmos DB
SQL Azure (предварительная версия)
Dapr3
Сетка событий
Центры событий
HTTP и веб-перехватчики
Центр Интернета вещей
Kafka2
Мобильные приложения
Центры уведомлений
Хранилище очередей
RabbitMQ2
SendGrid
Служебная шина
SignalR
Хранилище таблиц
Таймер
Twilio

1 Начиная со среды выполнения версии 2.х, все привязки, кроме HTTP и Timer, должны быть зарегистрированы. Ознакомьтесь с разделом Регистрация расширений привязки.

2 Триггеры не поддерживаются в плане потребления. Требуются триггеры, управляемые средой выполнения.

3 Поддерживается только в Kubernetes, IoT Edge и других автономных режимах.

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

Примеры кода привязок

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

Служба Примеры Примеры
Хранилище BLOB-объектов Триггер
Ввод
Выходные данные
Ссылка
Azure Cosmos DB Триггер
Ввод
Выходные данные
Ссылка
Сетка событий Azure Триггер
Выходные данные
Ссылка
Центры событий Триггер
Выходные данные
Центр Интернета вещей Триггер
Выходные данные
HTTP Триггер Ссылка
Хранилище очередей Триггер
Выходные данные
Ссылка
RabbitMQ Триггер
Выходные данные
SendGrid Выходные данные
Служебная шина Триггер
Выходные данные
Ссылка
SignalR Триггер
Ввод
Выходные данные
Хранилище таблиц Ввод
Выходные данные
Таймер Триггер Ссылка
Twilio Выходные данные Ссылка

Настраиваемые привязки

Вы можете создавать входные и выходные привязки. Привязки должны создаваться в .NET, но их можно использовать на любом поддерживаемом языке. Подробнее о создании настраиваемых привязок см. в разделе Создание настраиваемых входных и выходных привязок.

Ресурсы

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