Dela via

Köra en felaktivitet i Azure Data Factory och Synapse Analytics

  • Artikel

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:

  1. Sök efter Fel i fönstret Pipelineaktiviteter och dra en aktivitet som inte fungerar till pipelinearbetsytan.

  2. Välj den nya felaktiviteten på arbetsytan om den inte redan är markerad och fliken Inställningar för att redigera dess information.

    Visar användargränssnittet för en felaktivitet.

  3. Ange ett felmeddelande och en felkod. Dessa 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 utvärderas vid körning. String Ja
errorCode Felkoden som kategoriserar feltypen för felaktiviteten. Det kan vara dynamiskt innehåll som utvärderas vid körning. String Ja

Förstå felkoden för fel vid felaktivitet

Felmeddelandet och felkoden för en felaktivitet anges vanligtvis av användarna. 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 har angetts av användaren Felkoden som anges 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 anges 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 anges av användaren
Det dynamiska innehållet i errorCode kan inte tolkas som en sträng. Felmeddelandet som har angetts av användaren ErrorCodeNotString
Det dynamiska innehållet i errorCode matchas till null, en tom sträng eller blanksteg. Felmeddelandet som har 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 anges av användaren
Fältet errorCode saknas.* Felmeddelandet som har 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: