通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

  • 项目

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

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

提示

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

使用 UI 创建 Fail 活动

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

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

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

    Shows the UI for a Fail activity.

  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) 开发的，则不应发生此情况。

相关内容

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