Использование общедоступных параметров в потоке данных 2-го поколения

Подсказка

Дополнительные сведения об использовании этой возможности в сценариях непрерывной интеграции и непрерывного развертывания (CI/CD) см. в статье об архитектуре решений CI/CD и ALM для потока данных 2-го поколения и комплексном руководстве по параметризованному потоку данных 2-го поколения.

Параметры в потоке данных 2-го поколения позволяют динамически управлять потоками данных и настраивать их, что делает их более гибким и повторно используемым путем включения различных входных данных и сценариев без изменения самого потока данных. Это помогает упорядочить вещи, уменьшая потребность в нескольких потоках данных и централизованном управлении в одном параметризованном потоке данных.

Общедоступные параметры в Dataflow 2-го поколения — это новый режим, в котором можно разрешить запуск потока данных путем передачи значений параметров вне редактора Power Query через REST API Fabric или через собственные интерфейсы Fabric. Он позволяет иметь более динамическую работу с потоком данных, где каждый запуск может вызываться с разными параметрами, влияющими на запуск потока данных.

Предпосылки

Включение режима общедоступного параметра

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

Снимок экрана: кнопка

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

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

Нажмите кнопку "ОК ", чтобы зафиксировать эти изменения.

Если этот режим включен, вы получите уведомление в диалоговом окне "Управление параметрами", которое гласит "Режим общедоступного параметра включен" в верхней части диалогового окна.

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

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

Снимок экрана: параметры сохранения потока данных на домашней вкладке ленты.

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

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

  • Обязательные параметры: если параметр установлен как обязательный, чтобы выполнить поток данных, необходимо передать значение в задание. Выполнение завершается ошибкой, если значение не передается для параметра, заданного как обязательный.
  • Необязательные параметры: они также называются необязательными параметрами, и для запуска запуска не требуется передавать значение. Если значение не передается, текущее значение , определенное в параметре, используется для выполнения.

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

Замечание

Мы рекомендуем прочитать больше о активности обработки данных в конвейерах Fabric, чтобы понять все её возможности.

При создании конвейера в Fabric можно использовать действие потока данных для активации запуска потока данных 2-го поколения с поддержкой CI/CD с включенным режимом общедоступных параметров.

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

Снимок экрана: активность потока данных в конвейерах Fabric, позволяющая передавать параметры для запуска потока данных.

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

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

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

Поддерживаемые типы параметров

Подсказка

Читать и использовать REST API параметра Dataflow discover. Документация предоставляет все доступные типы параметров и их ожидаемые значения, а REST API предоставляет способ получения сведений о параметрах из потока данных.

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

Тип параметра потока данных Определение REST API
Текст DataflowStringParameter
Целое число (int64) DataflowIntegerParameter
Десятичное число DataflowNumberParameter
Date DataflowDateParameter
DateTime DataflowDateTimeParameter
Time DataflowTimeParameter
Часовой пояс даты и времени DataflowDateTimeZoneParameter
Продолжительность DataflowDurationParameter
Истина/Ложь DataflowBooleanParameter

Соображения и ограничения

Ниже приведен список всех рекомендаций и ограничений при использовании режима общедоступных параметров в Dataflow 2-го поколения с CI/CD:

  • Планирование и ручное активация. Потоки данных с общедоступными параметрами нельзя запланировать или вручную активировать с помощью Fabric, если только не заданы необходимые параметры.
  • Неподдерживаемая параметризация: параметры, изменяющие пути ресурсов для источников или назначений, не поддерживаются. Подключения закреплены к авторскому пути.
  • Добавочное обновление: несовместимо с режимом общедоступных параметров.
  • Изменение логики. Общедоступные параметры позволяют пользователям получать доступ к переопределенным значениям, потенциально изменяя выходные данные потока данных.
  • Центр мониторинга. Центр мониторинга не отображает значения параметров, используемые во время выполнения.
  • Промежуточное поведение: Только последнее выполнение хранится в системе Dataflow Staging Lakehouse и возвращается соединителем потока данных. Рекомендуется использовать место назначения данных для сохранения данных для каждого запуска.
  • Повторяющиеся запросы. Если одни и те же значения параметров отправляются несколько раз, то только первый запрос принимается до завершения.
  • Сопоставление схем. Параметры не могут изменять сопоставления целевых схем. Все сопоставления соответствуют конфигурации, созданной. Дополнительные сведения о назначениях данных и управляемых параметрах в потоке данных 2-го поколения см. в статье.
  • Last updated on