Поделиться через


Использование веб-действия для вызова REST API в конвейерах

Веб-действие можно использовать для вызова пользовательской конечной точки REST из конвейера Фабрики данных Azure или Synapse. Вы можете передать наборы данных и связанные службы, которые будет использовать это действие и к которым оно будет обращаться.

Примечание.

Максимальный поддерживаемый размер полезных данных выходного ответа составляет 4 МБ.

Необходимые компоненты

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

Добавление веб-действия в конвейер с пользовательским интерфейсом

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

Создание действия

  1. Создайте конвейер в рабочей области.

  2. Найдите Веб-сайт в области действий конвейера и выберите его, чтобы добавить его на холст конвейера.

    Снимок экрана: пользовательский интерфейс Fabric с выделенной областью действий и веб-действием.

  3. Выберите новое веб-действие на холсте, если оно еще не выбрано.

    Снимок экрана: вкладка

    Примечание.

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

Ознакомьтесь с руководством по общим параметрам, чтобы настроить вкладку "Общие параметры".

Параметры веб-действий

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

    Снимок экрана: вкладка

  2. При выборе +Создать для создания нового подключения отображается диалоговое окно создания подключения, в котором можно указать базовый URL-адрес и учетные данные для подключения.

    Снимок экрана: диалоговое окно нового подключения для веб-действия.

    Примечание.

    Имя подключения может содержать не более 80 символов.

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

  1. При создании подключения теперь можно использовать локальный шлюз данных (OPDG) или шлюз данных виртуальной сети. Рекомендации по созданию и настройке OPDG см. в руководстве по созданию локального шлюза данных

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

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

    Снимок экрана: диалоговое окно подключения шлюза данных для веб-действия.

  4. После выбора или создания подключения и шлюза данных заполните оставшиеся обязательные поля, добавьте все необходимые заголовки или задайте дополнительные параметры. Веб-действие поддерживает методы GET, POST, PUT, DELETE и PATCH.

  5. После выбора или создания подключения заполните оставшиеся обязательные поля, добавьте все необходимые заголовки или задайте дополнительные параметры. Веб-действие поддерживает методы GET, POST, PUT, DELETE и PATCH.

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

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

Снимок экрана: вкладка