Freigeben über


Verwenden Sie die Invoke-Pipeline-Aktivität, um eine andere Pipeline auszuführen.

Die Fabric Invoke-Pipelineaktivität kann eine andere Microsoft Fabric-Pipeline ausführen. Sie können sie verwenden, um die Ausführung einer oder mehrerer Pipelines innerhalb einer einzelnen Pipeline zu orchestrieren. Dies ist nützlich, um komplexe Workflows zu organisieren, wiederzuverwenden und zu verwalten. Die Aufrufpipelineaktivität kann sehr hilfreich sein, um wiederverwendbare, modulare Pipelinemuster zu erstellen, indem andere Pipelines aufgerufen werden, die einen bestimmten Zweck haben.

Prerequisites

Um zu beginnen, müssen die folgenden Voraussetzungen erfüllt sein:

Note

Zurzeit gibt es zwei Invoke-Pipeline-Aktivitäten. Die Invoke-Pipeline (Legacy) unterstützt nur Fabric-Pipelines im selben Arbeitsbereich wie ihrer übergeordneten Pipeline. Sie können auch nur die übergeordnete Pipeline überwachen und ADF-Pipelines (Azure Data Factory) oder Synapse-Pipelines nicht mit der veralteten Aktivität aufrufen. Mithilfe der neuen Invoke-Pipelineaktivität können Sie Pipelines zwischen den Fabric-Arbeitsbereichen über ADF oder Synapse aufrufen und untergeordnete Pipelines überwachen.

Hinzufügen einer Aufrufpipelineaktivität zu einer Pipeline mit Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine Aufrufpipelineaktivität in einer Pipeline zu verwenden:

Erstellen der Aktivität

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suchen Sie im Bereich Pipelineaktivitäten nach invoke pipeline und wählen Sie es aus, um es dem Pipeline-Zeichenbereich hinzuzufügen.

    Screenshot der Fabric-Benutzeroberfläche mit dem Bereich „Aktivitäten“ und hervorgehobener Aktivität „Pipeline aufrufen“.

    Screenshot zeigt das Bearbeitungsfenster der Pipeline mit der Schaltfläche „Pipeline aufrufen“ auf der Registerkarte „Aktivitäten“ ohne ihren beschreibenden Text.

  3. Wählen Sie die neue Aufrufpipelineaktivität auf der Canvas aus, wenn sie noch nicht ausgewählt ist.

    Screenshot der Registerkarte

Informationen zum Konfigurieren der Registerkarte Allgemein finden Sie unter Allgemeine Einstellungen-Anleitung.

Aufrufen von Pipelineeinstellungen (Legacy)

Wählen Sie die Registerkarte "Einstellungen " aus, und wählen Sie eine vorhandene Pipeline aus dem Dropdownmenü " Aufgerufene Pipeline " aus, oder verwenden Sie die Schaltfläche "+Neu ", um eine neue Pipeline direkt zu erstellen. Sie können auf den Abschluss warten oder direkt fortfahren. In diesem Fall wird die aufgerufene Pipeline parallel mit Aktivitäten ausgeführt, die ihr im Ausführungsablauf der übergeordneten Pipeline folgen.

Screenshot der Registerkarte

Einstellungen für „Pipeline aufrufen“

Wählen Sie die Registerkarte "Einstellungen " aus, und konfigurieren Sie Ihre Aktivität.

Aufrufen von Pipelines aus Fabric

  • Typ: Wählen Sie Fabric als die Quelle der Pipeline aus.

  • Verbindung: Jede Aufrufpipelineaktivität erfordert ein Connection-Objekt, das im secure Fabric-Anmeldeinformationsspeicher gespeichert ist. Dieses Verbindungsobjekt speichert Ihr Benutzertoken, das Ihrem Fabric-Arbeitsbereich zugeordnet ist. Wenn Sie noch keine neue Invoke-Pipelineaktivität erstellt haben, müssen Sie zuerst ein neues Verbindungsobjekt erstellen, bevor Sie die Aktivität verwenden können.

    Beim Einrichten der Pipelineverbindung haben Sie jetzt drei Optionen für die Authentifizierungsart: Organisationskonto, Dienstprinzipal oder Arbeitsbereichsidentität.

    Screenshot der Pipelineverbindung, die mit hervorgehobener Authentifizierungsart eingerichtet ist.

  • Arbeitsbereich: Wählen Sie den Fabric-Arbeitsbereich aus, in dem sich die Zielpipeline befindet, die Sie über die übergeordnete Pipeline aufrufen möchten.

  • Pipeline: Wählen Sie die Pipeline aus, die Sie aufrufen möchten.

Screenshot des Pipeline-Editor-Fensters mit dem Arbeitsbereich

Verwenden von Fabric Workspace Identity (WI) in Invoke-Pipelines

  1. Erstellen der Arbeitsbereichsidentität Erstellen Sie eine Arbeitsbereichsidentität in Ihrem Fabric-Arbeitsbereich. Sehen Sie sich die Dokumente für Arbeitsbereichsidentität an.

  2. Aktivieren von Einstellungen auf Mandantenebene Aktivieren Sie im Fabric-Verwaltungsportal die folgende Mandanteneinstellung: Dienstprinzipale können öffentliche Fabric-APIs aufrufen. Diese Einstellung ist erforderlich, damit die Arbeitsbereichsidentität erfolgreich authentifiziert werden kann. Sehen Sie sich die Dokumente zum Aktivieren der Dienstprinzipalauthentifizierung für Administrator-APIs an.

  3. Gewähren von Arbeitsbereichsberechtigungen für die Arbeitsbereichsidentität Öffnen Sie den Arbeitsbereich, wählen Sie "Zugriff verwalten" aus, und weisen Sie der Arbeitsbereichsidentität Berechtigungen zu. Der Mitwirkendezugriff ist für die meisten Szenarien ausreichend. Sehen Sie sich die Dokumentation zu Benutzern Zugriff auf Arbeitsbereiche gewähren an.

Aufrufen von Pipelines aus ADF und Synapse

  • Typ: Auswählen der Quelle Ihrer Pipeline (Fabric, Azure Data Factory, Synapse)
  • Verbindung: Referenz auf Fabric, Azure Data Factory oder Synapse als Verbindung registriert
  • Pipeline: Wählen Sie den Pipelinenamen aus, den Sie aufrufen möchten

Screenshot der Aktivitätseinstellungen der Registerkarte „Pipeline ausführen“, mit hervorgehobenen ADF und Synapse.

Speichern und Ausführen oder Planen der Pipeline

Wechseln Sie oben im Pipeline-Editor zur Registerkarte " Start ", und wählen Sie die Schaltfläche "Speichern" aus, um Ihre Pipeline zu speichern. Wählen Sie "Ausführen" aus, um sie direkt auszuführen, oder "Zeitplan" , um sie zu planen. Sie können hier auch den Ausführungsverlauf anzeigen oder andere Einstellungen konfigurieren.

Screenshot: Die Registerkarte „Start“ im Pipeline-Editor mit den hervorgehobenen Schaltflächen „Name“, „Speichern“, „Ausführen“ und „Planen“ der Registerkarte.