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

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

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

Требуемые условия

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

• У вас должен быть доступ к арендатору Microsoft Fabric с выделенной capacity. Вы можете try Fabric с помощью бесплатной пробной версии.
• Назначенное этой емкости пространство Fabric workspace.

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

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

Создание активности

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

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

   

3. Выберите новую операцию Lookup на холсте, если она еще не выбрана.

   

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

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

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

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

Кнопка Preview data в настройках действия Lookup позволяет просмотреть образец данных, который возвращает ваш запрос.

Предварительный просмотр данных поможет вам:

• Убедитесь, что таблица Или запрос Lakehouse возвращают ожидаемые столбцы и значения.
• Убедитесь, является ли результат одной строкой или несколькими строками
• Общие сведения о выходной фигуре (firstRow и value) перед ссылкой на нее в выражениях

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

После выполнения действия поиска возвращает результаты запроса на вкладке "Выходные данные" (которые должны быть теми же данными в представлении данных предварительного просмотра). Вы можете ссылаться на эти выходные данные в подчиненных действиях для управления динамическими конвейерами, управляемыми метаданными.

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

Выходные данные поиска обычно используются для:

• Логика управления ветвлением (например, если условие или переключатель)
• Цикл по строкам с помощью оператора ForEach

В этом примере демонстрируется действие If Condition, используя выходные данные действия Lookup.

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

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

Для действия поиска поддерживаются следующие источники данных.

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

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

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

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

• Мониторинг запусков конвейера