您有時可能需要在管線中刻意擲出錯誤。 查閱活動可能未傳回任何相符的資料，或 Custom 活動可能因內部錯誤而結束。 不論原因為何，現在您都可以在管線中使用失敗活動，並自訂其錯誤訊息與錯誤碼。
適用於：
Azure Data Factory Azure Synapse Analytics
秘訣
關於 Microsoft Fabric 中 Data Factory 中等效的活動，請參見失敗活動。
使用 UI 建立失敗活動
若要在管線中使用失敗活動，請完成下列步驟：
在管線活動窗格中搜尋失敗，然後將失敗活動拖曳至管線畫布。
如果尚未選取，請在畫布上選取新的失敗活動，並選取其設定索引標籤以編輯詳細資料。
語法
{
"name": "MyFailActivity",
"type": "Fail",
"typeProperties": {
"errorCode": "500",
"message": "My Custom Error Message"
}
}
類型屬性
| 屬性 | 描述 | 允許的值 | 必要 |
|---|---|---|---|
| 名稱 | 失敗活動的名稱。 | 字串 | 是 |
| 型別 | 必須設定為失敗。 | 字串 | 是 |
| 訊息 | 在失敗活動中顯示的錯誤訊息。 此內容可以是於執行階段評估的動態內容。 | 字串 | 是 |
| errorCode | 用於分類失敗活動錯誤類型的錯誤碼。 此內容可以是於執行階段評估的動態內容。 | 字串 | 是 |
了解失敗活動錯誤碼
管線作者通常會設定失敗活動的錯誤訊息與錯誤碼。 若要了解錯誤碼的特定意義，請聯絡管線開發人員。 然而，在以下的邊緣情況中，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) 開發，則不應發生此情況。
相關內容
請參閱其他支援的控制流程活動，包括：