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

Die Fabric Invoke-Pipelineaktivität kann eine weitere Microsoft Fabric Pipeline ausführen. Sie können es verwenden, um die Ausführung einer oder mehrerer Pipelines aus einer einzelnen Pipeline heraus 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 Legacy Invoke-Pipeline unterstützt nur Fabric-Pipelines im selben Arbeitsbereich wie die übergeordnete Pipeline. Sie können auch nur die übergeordnete Pipeline überwachen und keine ADF-Pipeline (Azure Data Factory) oder Synapse-Pipelines mithilfe der Legacyaktivität aufrufen. Mithilfe der neuen Invoke-Pipelineaktivität können Sie Pipelines über Fabric Arbeitsbereiche hinweg, ü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 hervorgehobener Option

    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

Pipeline-Einstellungen aufrufen

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

Aufrufen von Pipelines aus Fabric

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

  • Verbindung: Jede Invoke-Pipelineaktivität erfordert ein Connection-Objekt, das im sicheren 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 „Pipeline-Aktivität ausführen“ und „Verbindungsauswahl“.

Aufrufen von Pipelines aus ADF und Synapse

  • Typ: Auswählen der Quelle Ihrer Pipeline (Fabric, Azure Data Factory, Synapse)
  • Verbindung: Verweis 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.

Verwendung von Fabric Workspace Identity (WI) in der Notizbuchaktivität

  1. Erstellen der Arbeitsbereichsidentität

    Sie müssen WI in Ihrem Arbeitsbereich aktivieren (dies kann einen Moment dauern, bis es sich geladen hat). Erstellen Sie eine Arbeitsbereichsidentität in Ihrem Fabric Arbeitsbereich. Beachten Sie, dass das WI im selben Arbeitsbereich wie Ihre Pipeline erstellt werden soll.

    Sehen Sie sich die Dokumente für Arbeitsbereichsidentität an.

  2. Aktivieren von Einstellungen auf Mandantenebene

    Aktivieren Sie die folgende Mandanteneinstellung (standardmäßig deaktiviert): Service-Prinzipale können öffentliche Fabric-APIs aufrufen.

    Sie können diese Einstellung im verwaltungsportal Fabric aktivieren. Weitere Informationen zu dieser Einstellung finden Sie im Artikel zum Aktivieren der Dienstprinzipalauthentifizierung für Administrator-APIs.

  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. Wenn sich Ihr Notizbuch nicht im gleichen Arbeitsbereich wie Ihre Pipeline befindet, müssen Sie dem WI, das Sie im Arbeitsbereich Ihrer Pipeline erstellt haben, im Arbeitsbereich Ihres Notizbuchs mindestens Beitragsberechtigten-Zugriff zuweisen.

    Sehen Sie sich die Dokumentation zu Benutzern Zugriff auf Arbeitsbereiche gewähren an.

Speichern und ausführen oder die Pipeline planen

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 planen Sie die Ausführung zu bestimmten Zeiten oder Intervallen. Weitere Informationen zu Pipelineausführungen finden Sie unter: Pipelineausführungen planen.

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

Nach dem Ausführen können Sie die Ausführung der Pipeline überwachen und den Ausführungsverlauf über die Registerkarte Ausgabe unterhalb des Zeichenbereichs anzeigen.