Share via

Выполнение действия Fail в Фабрике данных Azure и Synapse Analytics

  • Статья

Иногда бывает необходимость специально вызвать ошибку в конвейере. Действие уточняющего запроса может не вернуть искомых данных, или пользовательское действие может завершить работу с внутренней ошибкой. Независимо от причины теперь в конвейере доступно действие Fail, для которого можно настроить сообщение об ошибке и код ошибки.

Область применения:Фабрика данных Azure Azure Synapse Analytics

Совет

Попробуйте использовать фабрику данных в Microsoft Fabric, решение для аналитики с одним интерфейсом для предприятий. Microsoft Fabric охватывает все, от перемещения данных до обработки и анализа данных в режиме реального времени, бизнес-аналитики и отчетности. Узнайте, как бесплатно запустить новую пробную версию !

Создание действия 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"
    }
}

Свойства типа

Свойство Description Допустимые значения Обязательное поле
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

* Такая ситуация обычно не возникает, если конвейер разрабатывается с помощью пользовательского интерфейса веб-интерфейса фабрики данных.

Связанный контент

Ознакомьтесь с другими поддерживаемыми действиями потока управления, в том числе: