在 Azure 数据工厂和 Synapse Analytics 中执行 Fail 活动
有时你可能需要特意引发管道中的错误。 也许 Lookup 活动没有返回任何匹配数据,或者 Custom 活动完成但引发了内部错误。 无论原因是什么,现在都可以在管道中使用 Fail 活动,并自定义错误消息和错误代码。
适用于: Azure 数据工厂 Azure Synapse Analytics
提示
试用 Microsoft Fabric 中的数据工厂,这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用!
使用 UI 创建 Fail 活动
若要在管道中使用 Fail 活动,请完成以下步骤:
在管道“活动”窗格中搜索“Fail”,然后将 Fail 活动拖动到管道画布上。
如果尚未选择画布上的新 Fail 活动,请选择它及其“设置”选项卡,以编辑其详细信息。
语法
{
"name": "MyFailActivity",
"type": "Fail",
"typeProperties": {
"errorCode": "500",
"message": "My Custom Error Message"
}
}
Type 属性
属性 | 说明 | 允许的值 | 必需 |
---|---|---|---|
name | Fail 活动的名称。 | 字符串 | 是 |
type | 必须设置为“Fail”。 | 字符串 | 是 |
message | Fail 活动中出现的错误消息。 可以是在运行时计算的动态内容。 | 字符串 | 是 |
errorCode | 对 Fail 活动的错误类型进行分类的错误代码。 可以是在运行时计算的动态内容。 | 字符串 | 是 |
了解 Fail 活动错误代码
管道作者通常设置 Fail 活动的错误消息和错误代码。 若要了解错误代码的具体含义,请联系管道开发人员。 但是,在以下边缘情况下,Azure 数据工厂会设置错误消息和/或错误代码。
情况说明 | 错误消息 | 错误代码 |
---|---|---|
已正确解释 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 |
* 如果管道是通过数据工厂的 Web 用户界面 (UI) 开发的,则不应发生此情况。
相关内容
请参阅其他受支持的控制流活动,包括: