Использование действия "Функции" для запуска функций пользовательских данных Fabric или Функций Azure

Действие "Функции" в Фабрике данных для Microsoft Fabric позволяет выполнять пользовательский код в рамках конвейера данных. При добавлении действия "Функции" вы выбираете тип функции для выполнения:

• Функции пользовательских данных Fabric: многократно используемые функции Python, которые создаются и управляются в Microsoft Fabric. Используйте функции пользовательских данных Fabric, если вы хотите централизировать бизнес-логику, которую можно вызвать из конвейеров, записных книжек, правил активатора или внешних приложений. Пользовательские функции данных идеально подходят для преобразований данных, правил проверки и бизнес-логики, которые должны быть согласованы в рабочих нагрузках Fabric.

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

В этой статье показано, как добавить действие "Функции" в конвейер и настроить его для любого типа функции.

Предварительные условия

Чтобы приступить к работе, необходимо выполнить следующие предварительные требования:

• У вас должен быть доступ к клиенту Microsoft Fabric с подготовленной вычислительной мощностью. Вы можете попробовать Fabric с бесплатной пробной версией.
• Рабочая область Fabric, назначенная этой емкости.

Добавьте действие Functions в конвейер

Действия, описанные в этом разделе, применимы как для настройки действий запуска пользовательских функций данных в Fabric, так и для Функций Azure. После добавления действия и настройки общих параметров выберите тип функции для запуска.

Чтобы добавить действие "Функции" в конвейер:

1. В рабочем пространстве выберите + Новый элемент.

2. В диалоговом окне «Создать элемент» найдите Pipeline и выберите его.

3. В диалоговом окне "Создать конвейер" введите имя конвейера и нажмите кнопку "Создать".

4. На домашней странице конвейера выберите вкладку "Действия ".

5. На ленте "Действия" щелкните значок ... (многоточие), чтобы просмотреть дополнительные действия.

6. Найдите Функции в списке действий под Orchestrate, а затем выберите Функции, чтобы добавить действие Функций на холст конвейера.

   

Настройка общих параметров

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

1. Выберите действие "Функции" на холсте редактора конвейера, если оно еще не выбрано.

2. Перейдите на вкладку "Общие ".

   

3. Введите название действия.

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

Дополнительные сведения см. в руководстве по общим параметрам .

Настройка активности для функций данных пользователя

Чтобы запустить функции пользовательских данных Fabric, настройте параметры действия следующим образом:

1. Выберите вкладку Параметры.

2. Выберите функции пользовательских данных Fabric как тип.

   

3. В раскрывающемся списке "Подключение" выберите подключение, которое вы хотите использовать. Если нужное подключение не отображается, нажмите кнопку "Обзор всех".

4. В диалоговом окне "Выбор источника данных для начала" найдите функции пользовательских данных и выберите его. Вы увидите его в разделе "Новые источники".

5. В диалоговом окне "Подключение к источнику данных" можно сохранить имя подключения и учетные данные по умолчанию. Убедитесь, что вы вошли в систему, а затем нажмите кнопку "Подключить".

   Примечание.

   Если у вас уже есть подключение, оно может быть выбрано в диалоговом окне. Вы можете сохранить существующее подключение или выбрать "Создать новое подключение " в раскрывающемся списке, чтобы создать новое.

6. Вернитесь к параметрам действия, выберите UserDataFunctions в раскрывающемся списке "Подключение ". Это только что созданное соединение.

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

8. Выберите имя элемента функций данных пользователя .

9. Выберите функцию , которую требуется вызвать.

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

Дополнительные сведения о создании и выполнении пользовательских функций данных в конвейерах см. в статье "Создание и запуск действий пользовательских функций данных" в конвейерах в документации по проектированию данных.

Настройка активности для функций Azure

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

Чтобы настроить действие для функций Azure, выполните следующие действия.

1. Выберите вкладку Параметры.

2. Выберите функцию Azure в качестве типа.

   

3. Выберите существующее подключение к функции Azure или создайте новую.

4. Укажите относительный URL-адрес функции , указывающий на относительный путь к функции приложения Azure в подключении функции Azure.

5. Выберите метод HTTP для отправки запроса на указанный URL-адрес.

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

Используйте локальный шлюз данных или шлюз данных виртуальной сети для функций Azure

Если приложение-функция Azure защищены за брандмауэром или частной сетью, можно использовать шлюз данных для установления безопасного подключения. Шлюзы данных являются мостом между Fabric и ресурсами, которые не доступны в общедоступном режиме:

• Локальный шлюз данных (OPDG) — установлен на сервере в сети. Она позволяет Fabric подключаться к функциям Azure через безопасный канал без открытия входящих портов.
• Шлюз данных виртуальной сети: управляемая служба, которая подключается к ресурсам Azure в виртуальной сети, не требуя локальной установки.

Инструкции по созданию и настройке OPDG см. в статье "Создание локального шлюза данных". Если вы хотите использовать шлюз виртуальной сети, см. инструкции по созданию шлюза данных виртуальной сети.

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

Требования к проверке подлинности

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

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

Сохраните и запустите конвейер или запланируйте его выполнение

Перейдите на вкладку "Главная " в верхней части редактора конвейера и нажмите кнопку "Сохранить", чтобы сохранить конвейер. Выберите "Выполнить" , чтобы запустить его напрямую или запланировать выполнение в определенный момент времени или интервалы. Дополнительные сведения о запусках конвейера см. в статье "Планирование запусков конвейера".

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

Связанный контент

• Обзор действий
• Мониторинг запусков конвейера
• Создание и запуск функций пользовательских данных в конвейерах