Spuštění aktivity selhání ve službě Azure Data Factory a Synapse Analytics
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:
Vyhledejte v podokně Aktivity kanálu selhání a přetáhněte aktivitu Selhání na plátno kanálu.
Pokud ještě není vybraná, vyberte novou aktivitu selhání na plátně a jeho kartu Nastavení a upravte její podrobnosti.
Zadejte chybovou zprávu a kód chyby. Tyto hodnoty mohou 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 má vyhodnotit 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 má vyhodnotit za běhu. | String | Ano |
Vysvětlení kódu chyby aktivity selhání
Autoři kanálu obvykle nastaví chybovou zprávu a kód chyby aktivity Selhání. 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< activity_name> neúspěšné zprávy 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é message errorCode 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ě: