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

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

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

Предпосылки

• Dataflow Gen2 с поддержкой CI/CD
• Параметры должны быть заданы в потоке данных.Дополнительные сведения о настройке параметров запроса в потоке данных.

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

• Потоки данных с включенным режимом общедоступных параметров нельзя запланировать для обновления с помощью планировщика Fabric. Единственным исключением является поток данных без набора обязательных параметров.
• Потоки данных с включенным режимом общедоступных параметров нельзя активировать вручную с помощью списка рабочих областей Fabric или представления происхождения. Единственным исключением является поток данных без набора обязательных параметров.
• Параметры, влияющие на маршрут ресурса в источнике данных или месте назначения, не поддерживаются. Подключения связаны с точным путем источника данных, определенным в созданном потоке данных, и в настоящее время не могут быть переопределены, чтобы использовать другие подключения или пути к ресурсам.
• Потоки данных с добавочным обновлением не могут использовать этот новый режим.
• Для переопределения можно передавать только параметры десятичного числа, целого числа, текста и true/false . Другие типы данных не создают запрос на обновление в журнале обновления, но отображаются в центре мониторинга.
• Режим общедоступных параметров позволяет пользователям изменять логику, определенную в потоке данных, переопределяя значения параметров. Это позволит другим пользователям, имеющим разрешения на поток данных, обновлять данные с другими значениями, что приводит к различным выходным данным из источников данных, используемых в потоке данных.
• Центр мониторинга не отображает сведения о параметрах, передаваемых во время вызова потока данных.
• Промежуточные запросы будут хранить только последнее обновление данных Dataflow, сохранённых в Staging Lakehouse. Пользователи могут просмотреть данные из системы хранения промежуточных данных Lakehouse, используя коннектор Dataflows, чтобы определить, какие данные хранятся. Определение назначений данных при использовании режима общедоступных параметров настоятельно рекомендуется.
• При отправке повторяющегося запроса для тех же значений параметров будет принято только первое запрос и последующее будет отклонено до тех пор, пока первый запрос не завершит его оценку.
• В контексте назначений данных параметры нельзя использовать для изменения схемы сопоставления. Обновление потока данных будет применять все сопоставления и параметры назначения данных, сохраненные потоком данных на этапе разработки. Дополнительные сведения о назначениях данных и управляемых параметрах в потоке данных 2-го поколения см. в статье.

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

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

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

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

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

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

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

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

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

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

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

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

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