通过

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

  • 项目

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

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

使用 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 数据工厂会设置错误消息和/或错误代码。

情况说明 错误消息 错误代码
已正确解释 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) 开发的，则不应发生此情况。

相关内容

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