Wykonywanie działania Niepowodzenie w usługach Azure Data Factory i Synapse Analytics

Czasami możesz chcieć wygenerować błąd w potoku celowo. Działanie Wyszukiwania może nie zwracać pasujących danych lub Działanie niestandardowe może zakończyć się błędem wewnętrznym. Niezależnie od przyczyny, możesz teraz użyć aktywności Fail w ramach potoku i dostosować zarówno komunikat o błędzie, jak i kod błędu.

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Dla równoważnej aktywności w Data Factory w Microsoft Fabric, zobacz Niepowodzenie aktywności.

Tworzenie działania Niepowodzenie za pomocą interfejsu użytkownika

Aby użyć aktywności Fail w pipelinie, wykonaj następujące kroki:

  1. Wyszukaj Niepowodzenie w okienku Aktywności potoku i przeciągnij aktywność Niepowodzenie na kanwę potoku.

  2. Wybierz nową aktywność Niepowodzenie w obszarze roboczym, jeśli nie została jeszcze wybrana, oraz kartę Ustawienia, aby edytować jej szczegóły.

    Pokazuje interfejs użytkownika dla aktywności Niepowodzenie.

  3. Wprowadź komunikat o błędzie i kod błędu. Te wartości mogą być wyrażeniami typu string lub dowolną kombinacją dynamicznych wyrażeń, funkcji, zmiennych systemowych lub wyników z innych działań.

Składnia

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

Właściwości typu

Właściwości opis Dozwolone wartości Wymagane
nazwa Nazwa działania Niepowodzenie. String Tak
typ Musi być ustawiona wartość Niepowodzenie. String Tak
komunikat Komunikat o błędzie, który pojawił się w działaniu Niepowodzenie. Może to być zawartość dynamiczna, która ma być oceniana w czasie wykonywania. String Tak
kod błędu Kod błędu, który kategoryzuje typ błędu dla operacji "Niepowodzenie". Może to być zawartość dynamiczna, która ma być oceniana w czasie wykonywania. String Tak

Poznawanie kodu błędu aktywności Fail

Autorzy potoków zwykle ustawiają komunikat o błędzie i kod błędu dla aktywności Niepowodzenie. Aby zrozumieć konkretne znaczenie kodów błędów, skontaktuj się z programistą pipeline'u. Jednak w następujących przypadkach brzegowych Azure Data Factory ustawia komunikat o błędzie i/lub kod błędu.

Opis sytuacji Komunikat o błędzie Kod błędu
Zawartość (dynamiczna) w message i errorCode jest poprawnie interpretowana. Komunikat o błędzie ustawiony przez użytkownika Kod błędu ustawiony przez użytkownika
Zawartość dynamiczna w obu message i errorCode nie może być interpretowana. "Nie można zinterpretować <activity_name> komunikatu o błędzie lub kodu błędu" ErrorCodeNotString
Nie można interpretować zawartości dynamicznej w pliku message jako ciągu. "<nie można zinterpretować parametru komunikatu o błędzie activity_name> jako ciągu" Kod błędu ustawiony przez użytkownika
Zawartość dynamiczna w pliku message jest rozpoznawana jako null, pusty ciąg lub białe spacje. "Nie można zinterpretować <activity_name> komunikatu o błędzie lub kodu błędu" Kod błędu ustawiony przez użytkownika
Nie można interpretować zawartości dynamicznej w pliku errorCode jako ciągu. Komunikat o błędzie ustawiony przez użytkownika ErrorCodeNotString
Zawartość dynamiczna w pliku errorCode jest rozpoznawana jako null, pusty ciąg lub białe spacje. Komunikat o błędzie ustawiony przez użytkownika ErrorCodeNotString
Wartość elementu message lub errorCode podana przez użytkownika nie jest możliwa do konwersji na łańcuch znaków. Pipeline kończy się niepowodzeniem z: "Nieprawidłowa wartość dla właściwości <errorCode/message>"
Brak message pola.* "Nie podano komunikatu o błędzie" Kod błędu ustawiony przez użytkownika
Brak errorCode pola.* Komunikat o błędzie ustawiony przez użytkownika ErrorCodeNotString

* Ta sytuacja nie powinna wystąpić, jeśli potok jest opracowywany za pomocą internetowego interfejsu użytkownika (UI) usługi Data Factory.

Powiązana zawartość

Zobacz inne wspierane operacje przepływu sterowania, w tym:

  • Last updated on