Freigeben über

Ausführen einer Fail-Aktivität in Azure Data Factory und Synapse Analytics

  • Artikel

Sie sollten von Zeit zu Zeit gelegentlich einen Fehler in einer Pipeline auslösen. Eine Lookup-Aktivität gibt möglicherweise keine übereinstimmenden Daten zurück, oder eine Benutzerdefinierte Aktivität beendet möglicherweise mit einem internen Fehler. Unabhängig vom Grund können Sie die Fail-Aktivität jetzt in einer Pipeline verwenden und sowohl deren Fehlermeldung als auch dessen Fehlercode anpassen.

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

Erstellen einer Fail-Aktivität mit Benutzeroberfläche

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

  1. Suchen Sie im Bereich mit den Pipelineaktivitäten nach Fail, und ziehen Sie eine Fail-Aktivität in den Pipelinebereich.

  2. Wählen Sie in diesem Bereich die neue Webhookaktivität aus (wenn sie noch nicht ausgewählt wurde), und wählen Sie anschließend die Registerkarte Einstellungen aus, um die Details zu bearbeiten.

    Benutzeroberfläche für eine Fail-Aktivität

  3. Geben Sie eine Fehlermeldung und einen Fehlercode ein. Diese Werte können literale Zeichenfolgenausdrücke oder eine beliebige Kombination aus dynamischen Ausdrücken, Funktionen, Systemvariablenoder Ausgaben von anderen Aktivitäten sein.

Syntax

{
    "name": "MyFailActivity",
    "type": "Fail",
    "typeProperties": {
        "errorCode": "500",
        "message": "My Custom Error Message"
    }
}

Typeigenschaften

Eigenschaft BESCHREIBUNG Zulässige Werte Erforderlich
name Name der Fail-Aktivität String Ja
type Muss auf Fail festgelegt sein String Ja
message In der Fail-Aktivität angezeigte Fehlermeldung. Es kann dynamischer Inhalt sein, der zur Laufzeit ausgewertet wird. String Ja
errorCode Der Fehlercode, der den Fehlertyp der Fail-Aktivität kategorisiert. Es kann dynamischer Inhalt sein, der zur Laufzeit ausgewertet wird. String Ja

Grundlegendes zum Fehlercode der Fail-Aktivität

Pipelineautoren legen die Fehlermeldung und den Fehlercode der Fail-Aktivität in ordnungsmäßig fest. Wenden Sie sich an die Pipelineentwickler*innen, um mehr über die spezifischen Bedeutungen der Fehlercodes zu erfahren. In den folgenden Edgefällen legt Azure Data Factory jedoch die Fehlermeldung und/oder den Fehlercode fest.

Situationsbeschreibung Fehlermeldung Fehlercode
Der (dynamische) Inhalt in message und errorCode wird richtig interpretiert. Vom Benutzer festgelegte Fehlermeldung Vom Benutzer festgelegter Fehlercode
Der dynamische Inhalt in message und errorCode kann nicht interpretiert werden. „Failed to interpret <Name_der_Aktivität> fail message or error code“ (Die Fehlermeldung oder der Fehlercode von konnte nicht interpretiert werden.) ErrorCodeNotString
Der dynamische Inhalt in message kann nicht als Zeichenfolge interpretiert werden. „Der Parameter der Fehlermeldung „<> konnte nicht als Zeichenfolge interpretiert werden.“ Vom Benutzer festgelegter Fehlercode
Der dynamische Inhalt in message wird zu NULL, einer leeren Zeichenfolge oder Leerzeichen aufgelöst. „Failed to interpret <Name_der_Aktivität> fail message or error code“ (Die Fehlermeldung oder der Fehlercode von konnte nicht interpretiert werden.) Vom Benutzer festgelegter Fehlercode
Der dynamische Inhalt in errorCode kann nicht als Zeichenfolge interpretiert werden. Vom Benutzer festgelegte Fehlermeldung ErrorCodeNotString
Der dynamische Inhalt in errorCode wird zu NULL, einer leeren Zeichenfolge oder Leerzeichen aufgelöst. Vom Benutzer festgelegte Fehlermeldung ErrorCodeNotString
Der Wert für message oder errorCode, der vom*von Benutzer*innen bereitgestellt wird, ist nicht zeichenfolgenfähig.* Die Pipeline schlägt mit folgender Meldung fehl: „Invalid value for property <errorCode/message>“ (Ungültiger Wert für Eigenschaft .)
Das Feld message fehlt.* „Die Fehlermeldung wurde nicht bereitgestellt.“ Vom Benutzer festgelegter Fehlercode
Das Feld errorCode fehlt.* Vom Benutzer festgelegte Fehlermeldung ErrorCodeNotString

* Diese Situation sollte bei Pipelines, die mit der Webbenutzeroberfläche von Data Factory entwickelt wurden, nicht auftreten.

Zugehöriger Inhalt

Machen Sie sich mit weiteren unterstützten Ablaufsteuerungsaktivitäten vertraut, z. B.: