Een mislukte activiteit uitvoeren in Azure Data Factory en Synapse Analytics

Soms wilt u een fout in een pijplijn opzettelijk veroorzaken. Een opzoekactiviteit retourneert mogelijk geen overeenkomende gegevens of een aangepaste activiteit kan worden voltooid met een interne fout. Wat de reden ook is, nu kunt u een mislukte activiteit in een pijplijn gebruiken en zowel het foutbericht als de foutcode aanpassen.

Van toepassing op: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory in Microsoft Fabric is de volgende generatie van Azure Data Factory, met een eenvoudigere architectuur, ingebouwde AI en nieuwe functies. Als u nieuw bent in gegevensintegratie, begint u met Fabric Data Factory. Bestaande ADF-workloads kunnen upgraden naar Fabric om toegang te krijgen tot nieuwe mogelijkheden voor gegevenswetenschap, realtime analyses en rapportage.

Een mislukte activiteit maken met de gebruikersinterface

Voer de volgende stappen uit om een Fail-activiteit in een pijplijn te gebruiken:

  1. Zoek naar Fail in het deelvenster Activiteiten van de pijplijn en sleep een Fail-activiteit naar het canvas van de pijplijn.

  2. Selecteer de nieuwe mislukte activiteit op het canvas als deze nog niet is geselecteerd en het tabblad Instellingen om de details ervan te bewerken.

    Toont de gebruikersinterface voor een mislukte activiteit.

  3. Voer een foutbericht en foutcode in. Deze waarden kunnen letterlijke tekenreeksexpressies zijn of een combinatie van dynamische expressies, functies, systeemvariabelen of uitvoer van andere activiteiten.

Syntaxis

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

Typeeigenschappen

Eigenschap Beschrijving Toegestane waarden Vereist
naam De naam van de mislukte activiteit. String Ja
type Moet zijn ingesteld op Mislukt. String Ja
bericht De foutmelding die verscheen in de activiteit Mislukt. Het kan dynamische inhoud zijn die tijdens runtime moet worden geëvalueerd. String Ja
foutcode De foutcode waarmee het fouttype van de mislukte activiteit wordt gecategoriseert. Het kan dynamische inhoud zijn die tijdens runtime moet worden geëvalueerd. String Ja

Inzicht in de foutcode van de mislukte activiteit

Pijplijnauteurs stellen gewoonlijk het foutbericht en de foutcode van de mislukte activiteit in. Neem contact op met de ontwikkelaar van de pijplijn om inzicht te krijgen in de specifieke betekenis van de foutcodes. In de volgende edge-gevallen stelt Azure Data Factory echter het foutbericht en/of de foutcode in.

Beschrijving van de situatie Foutmelding Foutcode
De (dynamische) inhoud in message en errorCode wordt correct geïnterpreteerd. Het foutbericht dat door de gebruiker is ingesteld De foutcode die door de gebruiker is ingesteld
De dynamische inhoud in beide message en errorCode kan niet worden geïnterpreteerd. Kon niet interpreteren <activity_name> foutbericht of foutcode ErrorCodeNotString
De dynamische inhoud in message kan niet worden geïnterpreteerd als een tekenreeks. "<activity_name> parameter voor mislukte berichten kan niet worden geïnterpreteerd als een tekenreeks" De foutcode die door de gebruiker is ingesteld
De dynamische inhoud in message wordt omgezet in null, een lege tekenreeks of witruimte. Kon niet interpreteren <activity_name> foutbericht of foutcode De foutcode die door de gebruiker is ingesteld
De dynamische inhoud in errorCode kan niet worden geïnterpreteerd als een tekenreeks. Het foutbericht dat door de gebruiker is ingesteld ErrorCodeNotString
De dynamische inhoud in errorCode wordt omgezet in null, een lege tekenreeks of witruimte. Het foutbericht dat door de gebruiker is ingesteld ErrorCodeNotString
De waarde voor message of errorCode die door de gebruiker is opgegeven, kan niet worden omgezet in een tekenreeks. Pijplijn faalt met: "Ongeldige waarde voor eigenschap <errorCode/message>"
Het message veld ontbreekt.* Foutmelding is niet opgegeven De foutcode die door de gebruiker is ingesteld
Het errorCode veld ontbreekt.* Het foutbericht dat door de gebruiker is ingesteld ErrorCodeNotString

* Deze situatie mag niet optreden als de pijplijn is ontwikkeld met de webgebruikersinterface (UI) van Data Factory.

Gerelateerde inhoud

Bekijk andere ondersteunde controlestroomactiviteiten, waaronder:

  • Last updated on