Udostępnij przez

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

Czasami możesz chcieć zgłosić błąd w potoku celowo. Działanie Odnośnika 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ć działania Niepowodzenie w potoku i dostosować zarówno komunikat o błędzie, jak i kod błędu.

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

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

Aby użyć działania Niepowodzenie w potoku, wykonaj następujące kroki:

  1. Wyszukaj ciąg Niepowodzenie w okienku Działania potoku i przeciągnij działanie Niepowodzenie na kanwę potoku.

  2. Wybierz nowe działanie Niepowodzenie na kanwie, jeśli nie zostało jeszcze wybrane, a jego karta Ustawienia , aby edytować jego szczegóły.

    Pokazuje interfejs użytkownika dla działania Niepowodzenie.

  3. Wprowadź komunikat o błędzie i kod błędu. Te wartości mogą być wyrażeniami ciągu literału lub dowolną kombinacją wyrażeń dynamicznych , funkcji, zmiennych systemowych lub danych wyjściowych 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 Wymagania
name Nazwa działania Niepowodzenie. String Tak
type Musi być ustawiona wartość Niepowodzenie. String Tak
wiadomość 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
errorCode Kod błędu, który kategoryzuje typ błędu działania Niepowodzenie. Może to być zawartość dynamiczna, która ma być oceniana w czasie wykonywania. String Tak

Informacje o kodzie błędu działania niepowodzenie

Autorzy potoków zwykle ustawiają komunikat o błędzie i kod błędu działania Niepowodzenie. Aby zrozumieć konkretne znaczenie kodów błędów, skontaktuj się z deweloperem potoku. Jednak w następujących przypadkach brzegowych usługa 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 pliku 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 elementach 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 w stanie ciągu.* Potok kończy się niepowodzeniem z: "Nieprawidłowa wartość właściwości></errorCodemessage"
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 obsługiwane działania przepływu sterowania, w tym:

  • Last updated on