執行 Azure Data Factory 和 Synapse Analytics 中的 Fail 活動

您偶爾可能會想要刻意在管線中擲回錯誤。 查閱活動可能不會傳回相符的資料，或者自訂活動完成時可能會出現內部錯誤。 不論原因為何，您現在都可以在管線中使用 Fail 活動，並自訂其錯誤訊息和錯誤碼。

適用於：Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory，這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費啟動新的試用版！

使用 UI 建立失敗活動

若要在管線中使用 Fail 活動，請完成下列步驟：

1. 在管線 [活動] 窗格中搜尋 Fail，然後將 Fail 活動拖曳至管線畫布。

2. 在畫布上選取新的 Fail 活動 (如未選取) 和其 [設定] 索引標籤以編輯詳細資料。

   

3. 輸入失敗訊息和錯誤碼。 這可以是常值字串運算式，或是任何動態運算式、函式、系統變數或其他活動輸出的組合。

語法

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

類型屬性

屬性	說明	允許的值	必要
NAME	Fail 活動的名稱。	String	Yes
type	必須設定為 Fail。	String	Yes
message	Fail 活動中呈現的錯誤訊息。 此錯誤碼可以是在執行階段進行評估的動態內容。	String	Yes
errorCode	將 Fail 活動的錯誤類型分類的錯誤碼。 此錯誤碼可以是在執行階段進行評估的動態內容。	String	Yes

了解 Fail 活動錯誤碼

Fail 活動的錯誤訊息和錯誤碼通常會由使用者設定。 若要了解錯誤碼的特定意義，請連絡管線開發人員。 不過，在下列邊緣案例中，是由 Azure Data Factory 來設定錯誤訊息和/或錯誤碼。

情況描述	錯誤訊息	錯誤碼
message 中的 (動態) 內容，且 errorCode 已正確解譯。	使用者設定的錯誤訊息	使用者設定的錯誤碼
message 和 errorCode 中的動態內容無法解譯。	「無法解譯 <activity_name > 失敗訊息或錯誤碼」	ErrorCodeNotString
message 中的動態內容無法解譯為字串。	「<activity_name> 失敗訊息參數無法解譯為字串」	使用者設定的錯誤碼
message 中的動態內容會解析為 null、空白字串或空白字元。	「無法解譯 <activity_name > 失敗訊息或錯誤碼」	使用者設定的錯誤碼
errorCode 中的動態內容無法解譯為字串。	使用者設定的錯誤訊息	ErrorCodeNotString
errorCode 中的動態內容會解析為 null、空白字串或空白字元。	使用者設定的錯誤訊息	ErrorCodeNotString
使用者所提供的 message 或 errorCode 值無法以字串方式提供。*	管線「失敗」原因：「<errorCode/message> 屬性的值無效」
message 欄位遺失。*	「未提供失敗訊息」	使用者設定的錯誤碼
errorCode 欄位遺失。*	使用者設定的錯誤訊息	ErrorCodeNotString

* 如果管線是以 Data Factory 的 Web 使用者介面 (UI) 開發，則不應發生此情況。

相關內容

查看其他支援的控制流程活動：

• If 條件活動
• 執行管線活動
• ForEach 活動
• GetMetadata 活動
• 查閱活動
• Web 活動
• Until 活動
• 了解管線錯誤