執行 Azure Data Factory 和 Synapse Analytics 中的 Fail 活動
您偶爾可能會想要刻意在管線中擲回錯誤。 查閱活動可能不會傳回相符的資料，或者自訂活動完成時可能會出現內部錯誤。 不論原因為何，您現在都可以在管線中使用 Fail 活動，並自訂其錯誤訊息和錯誤碼。
適用於：
Azure Data Factory Azure Synapse Analytics
提示
試用 Microsoft Fabric 中的 Data Factory，這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費啟動新的試用版！
使用 UI 建立失敗活動
若要在管線中使用 Fail 活動，請完成下列步驟：
在管線 [活動] 窗格中搜尋 Fail，然後將 Fail 活動拖曳至管線畫布。
在畫布上選取新的失敗活動 (如未選取) 和其 [設定] 索引標籤以編輯詳細資料。
語法
{
"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 活動錯誤碼
管線作者通常會設定失敗活動的錯誤訊息和錯誤碼。 若要了解錯誤碼的特定意義，請連絡管線開發人員。 不過，在下列邊緣案例中，是由 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) 開發，則不應發生此情況。
相關內容
查看其他支援的控制流程活動：