Использование действия подстановки для поиска данных из источника данных

Действие подстановки Fabric может получить набор данных из любого из источников данных, поддерживаемых Microsoft Fabric. Вы можете использовать его, чтобы динамически определять объекты для обработки в последующем действии, вместо жесткого программирования имени объекта. Примерами объектов могут быть файлы и таблицы.

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

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

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

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

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

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

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

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

    Screenshot of the Fabric UI with the Activities pane and Lookup activity highlighted.

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

    Screenshot showing the General settings tab of the Lookup activity.

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

Параметры поиска

Выберите вкладку Параметры, выберите существующее подключение в раскрывающемся списке Подключение ion или нажмите кнопку +Создать, чтобы создать новое подключение и указать сведения о конфигурации.

Screenshot showing the Lookup activity settings tab highlighting the tab, and where to choose a new connection.

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

Поддерживаемые возможности

  • Действие поиска может возвращать до 5000 строк; Если результирующий набор содержит больше записей, возвращаются первые 5000 строк.
  • Выходные данные действия подстановки поддерживают до 4 МБ размера; действие завершается ошибкой, если размер превышает предел.
  • Максимальная продолжительность действия Lookup до истечения времени ожидания составляет 24 часа.

Примечание.

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

Fabric поддерживает хранилища данных, перечисленные в статье обзора Подключение or. Данные из любого источника можно использовать.

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

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

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.