Считывание данных с помощью входных привязок

  • 5 мин

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

Типы входных привязок

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

  • Хранилище BLOB-объектов Azure: привязки для хранилища BLOB-объектов позволяют читать из объекта.

  • Azure Cosmos DB: входные привязки Azure Cosmos DB используют API SQL для получения одного или нескольких документов Azure Cosmos DB и передают их в входной параметр функции. Идентификатор документа или параметры запроса можно определить по триггеру, который вызывает функцию.

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

  • Хранилище таблиц Azure: вы можете считывать данные и работать с хранилищем таблиц Azure.

Полный список поддерживаемых привязок доступен здесь.

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

Что такое выражение привязки?

Выражение привязки — это специализированный текст в function.json, параметрах функции или коде, вычисляемом при вызове функции для получения значения. Например, если у вас есть привязка очереди служебной шины, выражение привязки можно использовать для получения имени очереди из параметров приложения.

Типы выражений привязки

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

  • Параметры приложения
  • Имя файла триггера
  • Метаданные триггера
  • Полезные данные JSON
  • Новый GUID
  • Текущие дата и время

Большинство выражений привязки идентифицируются путем их заключения в фигурные скобки. Однако выражения привязки параметров приложения упаковываются в знаки процента, а не фигурные скобки. Например, если путь выходной привязки большого двоичного объекта — %Environment%/newblob.txt, а значение параметра приложения среды — Development, в контейнере Development будет создан большой двоичный объект.

Итоги

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