在 Azure 数据工厂和 Synapse Analytics 中执行 Fail 活动

有时你可能需要特意引发管道中的错误。 也许 Lookup 活动没有返回任何匹配数据,或者 Custom 活动完成但引发了内部错误。 无论原因是什么,现在都可以在管道中使用 Fail 活动,并自定义错误消息和错误代码。

适用于: Azure 数据工厂 Azure Synapse Analytics

提示

试用 Microsoft Fabric 中的数据工厂,这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用

使用 UI 创建 Fail 活动

若要在管道中使用 Fail 活动,请完成以下步骤:

  1. 在管道“活动”窗格中搜索“Fail”,然后将 Fail 活动拖动到管道画布上。

  2. 如果尚未选择画布上的新 Fail 活动,请选择它及其“设置”选项卡,以编辑其详细信息

    显示“Fail”活动的 UI。

  3. 输入失败消息和错误代码。 这些值可以是文本字符串表达式,也可以是动态表达式、函数系统变量其他活动的输出的任意组合。

语法

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

Type 属性

属性 说明 允许的值 必需
name Fail 活动的名称。 字符串
type 必须设置为“Fail”。 字符串
message Fail 活动中出现的错误消息。 可以是在运行时计算的动态内容。 字符串
errorCode 对 Fail 活动的错误类型进行分类的错误代码。 可以是在运行时计算的动态内容。 字符串

了解 Fail 活动错误代码

管道作者通常设置 Fail 活动的错误消息和错误代码。 若要了解错误代码的具体含义,请联系管道开发人员。 但是,在以下边缘情况下,Azure 数据工厂会设置错误消息和/或错误代码。

情况说明 错误消息 错误代码
已正确解释 messageerrorCode 中的(动态)内容。 用户设置的错误消息 用户设置的错误代码
无法解释 messageerrorCode 中的动态内容。 “无法解释 <activity_name> 失败消息或错误代码” ErrorCodeNotString
message 中的动态内容无法解释为字符串。 “<activity_name> 失败消息参数无法解释为字符串” 用户设置的错误代码
message 中的动态内容解析为 null、空字符串或空格。 “无法解释 <activity_name> 失败消息或错误代码” 用户设置的错误代码
errorCode 中的动态内容无法解释为字符串。 用户设置的错误消息 ErrorCodeNotString
errorCode 中的动态内容解析为 null、空字符串或空格。 用户设置的错误消息 ErrorCodeNotString
由用户提供的 messageerrorCode 的值不能为字符串。* 管道失败并出现错误消息“属性 <errorCode/message> 的值无效”
缺少 message 字段。* “未提供失败消息” 用户设置的错误代码
缺少 errorCode 字段。* 用户设置的错误消息 ErrorCodeNotString

* 如果管道是通过数据工厂的 Web 用户界面 (UI) 开发的,则不应发生此情况。

请参阅其他受支持的控制流活动,包括: