Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Möglicherweise möchten Sie gelegentlich einen Fehler in einer Pipeline absichtlich auslösen. Eine Nachschlageaktivität möglicherweise keine übereinstimmenden Daten zurückgibt, oder eine Skriptaktivität möglicherweise mit einem internen Fehler beendet wird. Was auch immer der Grund sein kann, jetzt können Sie eine Fail-Aktivität in einer Pipeline verwenden und sowohl die Fehlermeldung als auch den Fehlercode anpassen.
Wann die Fail-Aktivität verwendet werden soll
Die Fail-Aktivität wird häufig in bedingten Szenarien verwendet, in denen die Pipeline basierend auf bestimmten Bedingungen fehlschlagen soll:
- Fehler bei der Datenüberprüfung: Wenn Daten keine Qualitätsstandards erfüllen
- Geschäftslogikverletzungen: Wenn Geschäftsregeln nicht erfüllt sind
- Abhängigkeitsprüfungen: Wenn erforderliche Ressourcen oder Datenquellen nicht verfügbar sind
- Benutzerdefinierte Fehlerbehandlung: Wenn Sie bestimmte Fehlerinformationen anstelle von generischen Systemfehlern bereitstellen möchten
Die Fail-Aktivität ist in der Regel mit anderen Aktivitäten verbunden, die bedingte Logik (Wenn Bedingungsaktivität) verwenden oder nach Aktivitäten platziert werden, die Fehlerbedingungen verursachen können.
Voraussetzungen
Um zu beginnen, müssen Sie die folgenden Voraussetzungen erfüllen:
- Ein Mandantenkonto mit einem aktiven Microsoft Fabric-Abonnement. Sie können Fabric mit einer kostenlosen Testversion testen.
- Ein Fabric-Arbeitsbereich.
Hinzufügen einer Fehleraktivität zu einer Pipeline über die Benutzeroberfläche
Führen Sie die folgenden Schritte aus, um eine Fail-Aktivität in einer Pipeline zu verwenden:
Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.
Suchen Sie im Bereich Aktivitäten in der Pipeline nach Fehleraktivität, und wählen Sie diese Option aus, um sie dem Pipelinecanvas hinzuzufügen. Es kann erforderlich sein, die Aktivitätsliste auf der rechten Seite des Bereichs zu erweitern, oder das Outlook-Symbol kann komprimiert werden, ohne Text darunter zu bezeichnen, wie in dieser Abbildung dargestellt, je nach Fensterbreite Ihres Browsers.
Wählen Sie die neue Fehleraktivität in der Canvas aus, wenn sie noch nicht ausgewählt ist.
Um die Registerkarte Allgemeine Einstellungen zu konfigurieren, beachten Sie die Allgemeine Einstellungen Anleitung.
Wählen Sie die Registerkarte Einstellungen aus, und geben Sie eine benutzerdefinierte Fehlermeldung und einen Fehlercode an, den die Pipeline melden soll, wenn die Aktivität aufgerufen wird. Diese Werte werden im Pipelineausführungsverlauf angezeigt und protokolliert, wenn die Fail-Aktivität ausgeführt wird, sodass Sie die spezifische Fehlerbedingung identifizieren können, die dazu führte, dass die Pipeline fehlschlug.
Speichern und Ausführen oder Planen der Pipeline
Die Fail-Aktivität wird in der Regel mit anderen Aktivitäten verwendet. Nachdem Sie also alle anderen aktivitäten konfiguriert haben, die für Ihre Pipeline erforderlich sind, führen Sie die folgenden Schritte aus:
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.
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.
Beispiel: Fehler bei bedingter Pipeline
Nachfolgend finden Sie ein gängiges Muster für das Fehlschlagen einer Pipeline basierend auf benutzerdefinierten Bedingungen:
- Verwenden Sie eine If Condition-Aktivität, um eine benutzerdefinierte Fehlerbedingung auszuwerten.
- Fügen Sie in der "True"-Verzweigung der If-Bedingung die Fail-Aktivität hinzu.
- Konfigurieren Sie die Fehleraktivität mit Ihrer benutzerdefinierten Fehlermeldung, die die spezifische Bedingung beschreibt, die erfüllt wurde.
- Setzen Sie in der False-Verzweigung die normale Pipeline-Ausführung fort.
Mit diesem Muster kann Ihre Pipeline sanft fehlschlagen und aussagekräftige Fehlermeldungen liefern, wenn auf bestimmte Geschäfts- oder Datenbedingungen gestoßen wird.