Поделиться через

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

  • Статья

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

ОБЛАСТЬ ПРИМЕНЕНИЯ: Фабрика данных Azure Azure Synapse Analytics

Совет

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

Создание действия Fail с помощью пользовательского интерфейса

Чтобы использовать действие Fail в конвейере, сделайте следующее:

  1. Выполните поиск элемента Fail на панели конвейера "Действия" и перетащите действие Fail на холст конвейера.

  2. Выберите новое действие fail на холсте, если оно еще не выбрано, и его вкладка "Параметры ", чтобы изменить его сведения.

    Отображает пользовательский интерфейс для действия fail.

  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

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

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

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