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
Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .
Een mislukte activiteit maken met de gebruikersinterface
Voer de volgende stappen uit om een mislukte activiteit in een pijplijn te gebruiken:
Zoek in het deelvenster Activiteiten van de pijplijn naar Fail en sleep een fail-activiteit naar het pijplijncanvas.
Selecteer de nieuwe mislukte activiteit op het canvas als deze nog niet is geselecteerd en het tabblad Instellingen om de details ervan te bewerken.
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
| Eigenschappen | Beschrijving | Toegestane waarden | Vereist |
|---|---|---|---|
| naam | De naam van de mislukte activiteit. | String | Ja |
| type | Moet zijn ingesteld op Mislukt. | String | Ja |
| bericht | Het foutbericht dat is opgetreden in de activiteit Mislukt. Het kan dynamische inhoud zijn die tijdens runtime moet worden geëvalueerd. | String | Ja |
| errorCode | 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. |
"Kan activity_name> foutbericht of foutcode niet interpreteren<" | 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 wordt omgezet in message null, een lege tekenreeks of spaties. |
"Kan activity_name> foutbericht of foutcode niet interpreteren<" | 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 wordt omgezet in errorCode null, een lege tekenreeks of spaties. |
Het foutbericht dat door de gebruiker is ingesteld | ErrorCodeNotString |
De waarde voor message of errorCode die door de gebruiker is opgegeven, is niet in staat om een tekenreeks uit te voeren.* |
Pijplijn mislukt met: 'Ongeldige waarde voor eigenschap/<>errorCodemessage' |
|
Het message veld ontbreekt.* |
'Foutbericht 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: