Действие функции Azure в Фабрике данных Azure
Область применения:
Фабрика данных Azure Azure Synapse Analytics
Совет
Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !
Действие функции Azure позволяет запускать Функции Azure в конвейере Фабрики данных Azure или Synapse. Чтобы запустить функцию Azure, необходимо создать подключение к связанной службе. Затем можно использовать связанную службу с действием, определяющим функцию Azure, которую вы планируете выполнить.
Создание действия функции Azure с помощью пользовательского интерфейса
Чтобы использовать действие функции Azure в конвейере, выполните следующие действия.
Разверните раздел функции Azure на панели действий конвейера и перетащите действие функции Azure на панель холста конвейера.
Выберите новое действие функции Azure на панели холста, если оно еще не выбрано, и перейдите на вкладку Параметры, чтобы изменить сведения о нем.
Если связанная служба функции Azure еще не определена, выберите "Создать", чтобы создать новую. В области новой связанной службы функции Azure выберите URL-адрес существующего приложения-функции Azure и укажите ключ функции.
После выбора связанной службы функции Azure укажите имя функции и другие сведения для завершения настройки.
Связанные службы функции Azure
Тип возвращаемого значения функции Azure должен быть допустимым объектом JObject. (Помните, что JArray неJObjectявляется .) Любой возвращаемый тип, отличный от JObject сбоя, и вызывает содержимое ответа на ошибку пользователя не является допустимым JObject.
Ключ функции обеспечивает безопасный доступ к имени функции, каждая из которых имеет отдельные уникальные ключи или главный ключ в приложении-функции. Управляемое удостоверение обеспечивает безопасный доступ ко всему приложению-функции. Пользователю необходимо предоставить ключ для доступа к имени функции. Дополнительные сведения о ключе доступа к функции см. в документации по функции.
| Свойство | Description | Обязательный |
|---|---|---|
| Тип | Свойство type должно иметь значение: AzureFunction | Да |
| URL-адрес приложения-функции | URL-адрес для приложения-функции Azure. Формат – https://<accountname>.azurewebsites.net. Этот URL-адрес – это значение в разделе URL при просмотре приложения-функции на портале Azure |
Да |
| Ключ функции | Ключ доступа для функции Azure. Щелкните раздел Управление для соответствующей функции и скопируйте Function Key (ключ функции) или Host key (ключ хоста). Дополнительные сведения см. здесь: Функции Azure триггеры и привязки HTTP | Да |
| Проверка подлинности | Метод проверки подлинности, используемый для вызова функции Azure. Поддерживаемые значения: "Управляемое удостоверение, назначаемое системой" или "Анонимно". | Да |
| ИД ресурса | Идентификатор приложения (клиента) функции Azure. Перейдите в раздел проверки подлинности для соответствующей функции и получите идентификатор приложения (клиента) в разделе поставщика удостоверений. Это свойство будет отображаться при использовании управляемого удостоверения, назначаемого системой. Дополнительные сведения см. в статье "Настройка Служба приложений или Функции Azure приложения для использования имени входа Microsoft Entra". | No |
Примечание.
При использовании анонимной проверки подлинности убедитесь, что вы сняли удостоверение на стороне функции Azure.
Действия функции Azure
| Свойство | Description | Допустимые значения | Обязательный |
|---|---|---|---|
| Имя. | Имя действия в конвейере. | Строка | Да |
| Тип | Тип действия – "AzureFunctionActivity" | Строка | Да |
| Связанная служба | Связанная служба функции Azure для соответствующего приложения-функции Azure | Ссылка на связанную службу | Да |
| Имя функции | Имя функции, которую вызывает это действие в приложении-функции Azure | Строка | Да |
| Способ | Метод REST API для вызова функции | Поддерживаемые типы строк: GET, POST и PUT | Да |
| Верхний колонтитул | Заголовки, которые отправляются в запрос. Например, чтобы задать язык и тип запроса: "заголовки": { "Accept-Language": "en-us", "Content-Type": "application/json" } | Строка (или выражение с типом результата "строка") | No |
| Основной текст | Текст, который отправляется вместе с запросом для функции метода API | Строка (или выражение с типом результата "строка") или объект. | Необходимо для методов PUT или POST |
Просмотрите схему полезных данных запроса в разделе Схема полезных данных запроса.
Маршрутизация и запросы
Действие функции Azure поддерживает маршрутизацию. Например, если у функции Azure есть конечная точка https://functionAPP.azurewebsites.net/api/<functionName>/<value>?code=<secret>, в качестве functionName в действии функции Azure используется <functionName>/<value>. Эту функцию можно параметризовать, чтобы обеспечить требуемое значение functionName во время выполнения.
Примечание.
functionNameдля устойчивых функций следует взять из свойства route привязки функции в ее определении в формате JSON, чтобы включить сведения о маршрутизации. Простое использование functionName без включения сведений о маршруте приведет к сбою, так как не удастся найти приложение-функцию.
Действие функции Azure поддерживает запросы. Запрос нужно включить в состав functionName. Например, если имя функции — HttpTriggerCSharp, а запрос, который нужно включить, — name=hello, можно создать functionName в действии функции Azure в таком виде: HttpTriggerCSharp?name=hello. Эту функцию можно параметризовать, чтобы значение можно было определить во время выполнения.
Время ожидания и длительные функции
Время ожидания функций Azure истекает через 230 секунд независимо от заданного значения параметра functionTimeout. Дополнительные сведения см. в этой статье. Если такое поведение нежелательно, можно использовать асинхронный шаблон или Устойчивые функции. Преимуществом Устойчивых функций является то, что они предлагают собственный механизм отслеживания состояния, поэтому вам не придется реализовывать его.
Узнайте больше об Устойчивых функциях в этой статье. Вы можете настроить действие Функции Azure для вызова Устойчивой функции, которая вернет ответ с другим универсальным кодом ресурса (URI), как в этом примере. Так как statusQueryGetUri возвращает состояние HTTP 202 во время выполнения функции, вы можете опросить состояние функции с помощью веб-действия. Настройте веб-действие с полем url, для которого задано значение @activity('<AzureFunctionActivityName>').output.statusQueryGetUri. После завершения работы Устойчивой функции выходные данные функции будут выходными данными веб-действия.
Пример
Пример, который использует функцию Azure для извлечения содержимого TAR-файла, можно найти здесь.
Связанный контент
Узнайте больше о поддерживаемых действиях из статьи Конвейеры и действия.