Verwenden von öffentlichen Parametern in Dataflow Gen2

Mit Parametern in Dataflow Gen2 können Sie Datenflüsse dynamisch steuern und anpassen, wodurch sie flexibler und wiederverwendbar sind, indem sie verschiedene Eingaben und Szenarien ermöglichen, ohne den Datenfluss selbst zu ändern. Sie hilft dabei, dinge zu organisieren, indem die Notwendigkeit mehrerer Datenflüsse reduziert und die Steuerung innerhalb eines einzelnen parametrisierten Datenflusses zentralisiert wird.

Öffentliche Parameter in Dataflow Gen2 ist ein neuer Modus, in dem Sie zulassen können, dass Ihr Dataflow ausgeführt werden kann, indem Sie Parameterwerte außerhalb des Power Query-Editors über die Fabric-REST-API oder über systemeigene Fabric-Oberflächen übergeben. Es ermöglicht Ihnen eine dynamischere Erfahrung mit Ihrem Dataflow, in dem jede Ausführung mit verschiedenen Parametern aufgerufen werden kann, die sich auf die Ausführung von Dataflow auswirken.

Voraussetzungen

• Dataflow Gen2 mit CI/CD-Unterstützung
• Parameter müssen in Ihrem Dataflow festgelegt werden.Erfahren Sie mehr über das Festlegen von Abfrageparametern in Dataflow.

Aktivieren des öffentlichen Parametermodus

Öffnen Sie den Datenfluss als dessen Besitzer. Wählen Sie auf der Registerkarte "Start" des Menübands die Schaltfläche "Optionen " aus.

Durch Auswählen der Schaltfläche wird ein neues Dialogfeld "Optionen " geöffnet. Wählen Sie die Option mit dem Label Parameters im vertikalen Menü innerhalb der Datenflussgruppe aus. Im Abschnitt "Parameter" können Sie die Option „Parameter können erkannt und für die Ausführung überschrieben werden“ aktivieren, um den Modus für öffentliche Parameter zu aktivieren.

Wählen Sie die Schaltfläche "OK " aus, um diese Änderungen zu übernehmen.

Wenn dieser Modus aktiviert ist, wird oben im Dialogfeld " Parameter verwalten" eine Benachrichtigung mit dem Text "Öffentlicher Parametermodus ist aktiviert" angezeigt.

Nachdem der öffentliche Parametermodus aktiviert wurde, können Sie den Datenfluss speichern.

Übergeben von benutzerdefinierten Parameterwerten für Dataflow-Ausführungen

Der öffentliche Parametermodus folgt der Definition der Parameter innerhalb des Datenflusses, wobei zwischen erforderlichen und nicht angeforderten Parametern unterschieden wird.

• Erforderliche Parameter: Wenn ein Parameter wie erforderlich festgelegt ist, muss ein Wert zum Ausführen des Datenflusses an den Ausführungsauftrag übergeben werden. Die Ausführung schlägt fehl, wenn kein Wert für einen Parameter übergeben wird, der auf erforderlich festgelegt ist.
• Nicht erforderliche Parameter: Diese werden auch als optionale Parameter bezeichnet, und es muss kein Wert übergeben werden, damit eine Ausführung ausgelöst wird. Wenn kein Wert übergeben wird, wird der in Ihrem Parameter definierte Current-Wert für die Ausführung verwendet.

Verwenden Sie die Dataflow-Aktivität in Pipelines

Wenn Sie eine Pipeline in Fabric erstellen, können Sie die Dataflow-Aktivität verwenden, um die Ausführung einer Dataflow Gen2 mit CI/CD-Unterstützung auszulösen, die den modus für öffentliche Parameter aktiviert hat.

Sie können den zu verwendenden Datenfluss auswählen und die Parameter festlegen, die Sie im Abschnitt "Dataflow-Parameter " verwenden möchten.

Im Abschnitt "Dataflow-Parameter " können Sie alle in Ihrem Dataflow verfügbaren Parameter und den Standardwert aus jedem Innerhalb des Wertabschnitts anzeigen.

Erforderliche Parameter weisen ein Sternchen neben ihrem Namen auf, während optionale Parameter nicht. Gleichzeitig können optionale Parameter aus dem Raster entfernt werden, während erforderliche Parameter nicht gelöscht werden können und ein Wert übergeben werden muss, damit der Datenfluss ausgeführt werden kann.

Sie können die Schaltfläche "Aktualisieren" auswählen, um die neuesten Parameterinformationen aus Ihrem Datenfluss anzufordern.

Unterstützte Parametertypen

In der folgenden Tabelle sind die derzeit unterstützten Parametertypen und der Link zur REST-API-Definition aufgeführt, um zu verstehen, welche Werte von der REST-API erwartet werden.

Überlegungen und Einschränkungen

Es folgt eine Liste aller Überlegungen und Einschränkungen bei der Verwendung des öffentlichen Parametermodus in Dataflow Gen2 mit CI/CD:

• Planung und manuelles Auslösen: Datenflüsse mit öffentlichen Parametern können nicht über Fabric geplant oder manuell ausgelöst werden, es sei denn, es werden keine erforderlichen Parameter festgelegt.
• Nicht unterstützte Parameterisierung: Parameter, die Ressourcenpfade für Quellen oder Ziele ändern, werden nicht unterstützt. Verbindungen sind mit dem verfassten Pfad festgelegt.
• Inkrementelle Aktualisierung: Nicht kompatibel mit dem modus für öffentliche Parameter.
• Logikänderung: Öffentliche Parameter ermöglichen Benutzern den Zugriff auf Außerkraftsetzungswerte, was die Datenflussausgabe potenziell ändert.
• Monitoring Hub: Der Monitoring Hub zeigt keine Parameterwerte an, die während der Ausführung verwendet werden.
• Stagingverhalten: Nur die neueste Ausführung wird im Staging Lakehouse gespeichert. Verwenden Sie definierte Ziele, um Daten aufzubewahren.
• Doppelte Anforderungen: Wenn dieselben Parameterwerte mehrmals übermittelt werden, wird nur die erste Anforderung akzeptiert, bis sie abgeschlossen ist.
• Schemazuordnung: Parameter können keine Zielschemazuordnungen ändern. Alle Zuordnungen folgen der erstellten Konfiguration. Weitere Informationen zu Datenzielen und verwalteten Einstellungen in Dataflow Gen2 finden Sie im Artikel.