Köra en felaktivitet i Azure Data Factory och Synapse Analytics
Ibland kanske du vill utlösa ett fel i en pipeline avsiktligt. En sökningsaktivitet kanske inte returnerar några matchande data, eller så kan en anpassad aktivitet avslutas med ett internt fel. Oavsett orsak kan du nu använda en felaktivitet i en pipeline och anpassa både dess felmeddelande och felkod.
GÄLLER FÖR: 
Azure Data Factory Azure Synapse Analytics
Dricks
Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!
Skapa en felaktivitet med användargränssnittet
Utför följande steg för att använda en felaktivitet i en pipeline:
Sök efter Fel i fönstret Pipelineaktiviteter och dra en aktivitet som inte fungerar till pipelinearbetsytan.
Välj den nya felaktiviteten på arbetsytan om den inte redan är markerad och fliken Inställningar för att redigera dess information.
Ange ett felmeddelande och en felkod. Dessa värden kan vara literala stränguttryck eller valfri kombination av dynamiska uttryck, funktioner, systemvariabler eller utdata från andra aktiviteter.
Syntax
{
"name": "MyFailActivity",
"type": "Fail",
"typeProperties": {
"errorCode": "500",
"message": "My Custom Error Message"
}
}
Typegenskaper
| Property | beskrivning | Tillåtna värden | Obligatoriskt |
|---|---|---|---|
| name | Namnet på aktiviteten Fail (Misslyckas). | String | Ja |
| type | Måste anges till Misslyckas. | String | Ja |
| meddelande | Felmeddelandet som visades i aktiviteten Fel. Det kan vara dynamiskt innehåll som ska utvärderas vid körning. | String | Ja |
| errorCode | Felkoden som kategoriserar feltypen för felaktiviteten. Det kan vara dynamiskt innehåll som ska utvärderas vid körning. | String | Ja |
Förstå felkoden för fel vid felaktivitet
Pipelineförfattare anger vanligtvis felmeddelandet och felkoden för aktiviteten Fail (Fel). Kontakta pipelineutvecklaren för att förstå de specifika innebörderna av felkoderna. I följande gränsfall anger Dock Azure Data Factory felmeddelandet och/eller felkoden.
| Beskrivning av situation | Felmeddelande | Felkod |
|---|---|---|
Innehållet (dynamiskt) i message och errorCode tolkas korrekt. |
Felmeddelandet som angetts av användaren | Felkoden som angetts av användaren |
Det dynamiska innehållet i båda message och errorCode kan inte tolkas. |
"Det gick inte att tolka <activity_name> felmeddelande eller felkod" | ErrorCodeNotString |
Det dynamiska innehållet i message kan inte tolkas som en sträng. |
"<activity_name> felmeddelandeparameter kunde inte tolkas som en sträng" | Felkoden som angetts av användaren |
Det dynamiska innehållet i message matchas till null, en tom sträng eller blanksteg. |
"Det gick inte att tolka <activity_name> felmeddelande eller felkod" | Felkoden som angetts av användaren |
Det dynamiska innehållet i errorCode kan inte tolkas som en sträng. |
Felmeddelandet som angetts av användaren | ErrorCodeNotString |
Det dynamiska innehållet i errorCode matchas till null, en tom sträng eller blanksteg. |
Felmeddelandet som angetts av användaren | ErrorCodeNotString |
Värdet för message eller errorCode som tillhandahålls av användaren kan inte stränghanteras.* |
Pipelinen misslyckas med: "Ogiltigt värde för egenskapen/<>errorCodemessage " |
|
Fältet message saknas.* |
"Det gick inte att skicka meddelandet" | Felkoden som angetts av användaren |
Fältet errorCode saknas.* |
Felmeddelandet som angetts av användaren | ErrorCodeNotString |
* Den här situationen bör inte inträffa om pipelinen har utvecklats med webbanvändargränssnittet (UI) för Data Factory.
Relaterat innehåll
Se andra kontrollflödesaktiviteter som stöds, inklusive: