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

  • 5 мин

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

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

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

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

  • 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, параметрах функции или коде.