Sdílet prostřednictvím

Spuštění aktivity selhání ve službě Azure Data Factory a Synapse Analytics

  • Článek

Někdy můžete chtít v kanálu záměrně vyvolat chybu. Aktivita vyhledávání nemusí vracet žádná odpovídající data nebo vlastní aktivita se může dokončit vnitřní chybou. Bez ohledu na to, proč to může být, teď můžete v kanálu použít aktivitu selhání a přizpůsobit její chybovou zprávu i kód chyby.

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Vytvoření aktivity selhání s uživatelským rozhraním

Pokud chcete v kanálu použít aktivitu selhání, proveďte následující kroky:

  1. Vyhledejte v podokně Aktivity kanálu selhání a přetáhněte aktivitu Selhání na plátno kanálu.

  2. Vyberte novou aktivitu selhání na plátně, pokud ještě není vybraná, a její Nastavení kartu pro úpravu podrobností.

    Shows the UI for a Fail activity.

  3. Zadejte chybovou zprávu a kód chyby. Mohou to být literální řetězcové výrazy nebo libovolná kombinace dynamických výrazů, funkcí, systémových proměnných nebo výstupů z jiných aktivit.

Syntaxe

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

Vlastnosti typu

Vlastnost Popis Povolené hodnoty Požaduje se
name Název aktivity Selhání. String Ano
type Musí být nastavena na hodnotu Selhání. String Ano
zpráva Chybová zpráva, která se zobrazila v aktivitě selhání. Může se jednat o dynamický obsah, který se vyhodnocuje za běhu. String Ano
Errorcode Kód chyby, který kategorizuje typ chyby aktivity Selhání. Může se jednat o dynamický obsah, který se vyhodnocuje za běhu. String Ano

Vysvětlení kódu chyby aktivity selhání

Chybová zpráva a kód chyby aktivity selhání jsou obvykle nastaveny uživateli. Pokud chcete porozumět konkrétním významům kódů chyb, obraťte se na vývojáře kanálu. V následujících hraničních případech ale Azure Data Factory nastaví chybovou zprávu nebo kód chyby.

Popis situace Chybová zpráva Kód chyby
Obsah (dynamický) v message obsahu a errorCode je interpretován správně. Chybová zpráva nastavená uživatelem Kód chyby nastavený uživatelem
Dynamický obsah v obou message a errorCode nelze jej interpretovat. Nepodařilo se interpretovat <activity_name> neúspěšnou zprávu nebo kód chyby. ErrorCodeNotString
Dynamický obsah nelze message interpretovat jako řetězec. Parametr< zprávy activity_name> selhání nelze interpretovat jako řetězec. Kód chyby nastavený uživatelem
Dynamický obsah se message překládá na hodnotu null, prázdný řetězec nebo prázdné mezery. Nepodařilo se interpretovat <activity_name> neúspěšnou zprávu nebo kód chyby. Kód chyby nastavený uživatelem
Dynamický obsah nelze errorCode interpretovat jako řetězec. Chybová zpráva nastavená uživatelem ErrorCodeNotString
Dynamický obsah se errorCode překládá na hodnotu null, prázdný řetězec nebo prázdné mezery. Chybová zpráva nastavená uživatelem ErrorCodeNotString
Hodnota zadané messageerrorCode uživatelem není schopna řetězce.* Kanál selže s chybou: Neplatná hodnota vlastnosti <errorCode/message>
Pole message chybí.* Zpráva o selhání nebyla k dispozici. Kód chyby nastavený uživatelem
Pole errorCode chybí.* Chybová zpráva nastavená uživatelem ErrorCodeNotString

* Tato situace by neměla nastat, pokud je kanál vyvinut pomocí webového uživatelského rozhraní (UI) služby Data Factory.

Související obsah

Podívejte se na další podporované aktivity toku řízení, včetně: