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

  • Статья
  • Чтение занимает 6 мин

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

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

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

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

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

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

Пример сценария Триггер Входные привязки Выходные привязки
Поступает новое сообщение очереди, которое запускает функцию для записи в другую очередь. Очереди* None Очереди*
Запланированное задание считывает содержимое хранилища BLOB-объектов и создает новый документ Azure Cosmos DB. Таймер Хранилище BLOB-объектов Azure Cosmos DB
Сетка событий используется для чтения изображения из хранилища BLOB-объектов и документа из Azure Cosmos DB для отправки сообщения электронной почты. Сетка событий Хранилище BLOB-объектов и Azure 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 ✔ ✔ ✔ ✔ ✔
Azure SQL (предварительная версия) ✔ ✔ ✔
Дапр3 ✔ ✔ ✔ ✔
Сетка событий ✔ ✔ ✔ ✔
Центры событий ✔ ✔ ✔ ✔
HTTP и веб-перехватчики ✔ ✔ ✔ ✔
Центр Интернета вещей ✔ ✔ ✔
Кафка2 ✔ ✔ ✔
Мобильные приложения ✔ ✔ ✔
Центры уведомлений ✔ ✔
Хранилище очередей ✔ ✔ ✔ ✔
RabbitMQ2 ✔ ✔ ✔
SendGrid ✔ ✔ ✔
Служебная шина ✔ ✔ ✔ ✔
SignalR ✔ ✔ ✔ ✔
Хранилище таблиц ✔ ✔ ✔ ✔
Таймер ✔ ✔ ✔
Twilio ✔ ✔ ✔

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

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

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

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

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

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

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

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

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

Ресурсы

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

Регистрация расширений привязки Функций Azure