Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Иногда может потребоваться создать ошибку в конвейере намеренно. Действие подстановки может не возвращать соответствующие данные, или действие скрипта может завершиться внутренней ошибкой. Независимо от причины, теперь вы можете использовать действие fail в конвейере и настроить как его сообщение об ошибке, так и код ошибки.
Когда следует использовать действие Fail
Действие отказ обычно используется в условных сценариях, в которых необходим сбой конвейера на основе определенных условий.
- Сбои проверки данных: если данные не соответствуют стандартам качества
- Нарушения бизнес-логики: когда бизнес-правила не удовлетворены
- Проверки зависимостей: если необходимые ресурсы или источники данных недоступны
- Настраиваемая обработка ошибок: если требуется предоставить определенные сведения об ошибках вместо универсальных системных ошибок
Действие fail обычно подключено к другим действиям с помощью условной логики (если действие условия) или помещается после действий, которые могут привести к ошибкам.
Необходимые условия
Чтобы приступить к работе, необходимо выполнить следующие предварительные требования:
- У вас должен быть доступ к клиенту Microsoft Fabric с подготовленной вычислительной мощностью. Вы можете попробовать Fabric с бесплатной пробной версией.
- Рабочая область Fabric, назначенная этой емкости.
Добавьте действие Fail в конвейер с графическим интерфейсом пользователя
Чтобы использовать действие Fail в конвейере, выполните следующие шаги.
Создайте конвейер в рабочей области.
Найдите действие "завершение с ошибкой" на панели действий конвейера и выберите его, чтобы добавить на холст конвейера. Возможно, потребуется развернуть список действий в правой части области или значок Outlook можно сжать без добавления меток под ним, как показано на этом изображении, в зависимости от ширины окна браузера.
Выберите новое действие Fail на холсте, если оно еще не выбрано.
Обратитесь к руководству по общим настройкам, чтобы настроить вкладку общих настроек.
Выберите вкладку "Параметры " и укажите пользовательское сообщение об ошибке и код ошибки, который вы хотите сообщить конвейеру при вызове действия. Эти значения будут отображаться в истории запусков и журналах конвейера при выполнении операции 'Fail', помогая определить конкретное условие ошибки, которое привело к сбою конвейера.
Сохраните и запустите или запланируйте выполнение конвейера
Действие Fail обычно используется с другими действиями, поэтому после настройки других действий, необходимых для конвейера, выполните следующие действия:
Перейдите на вкладку "Главная " в верхней части редактора конвейера и нажмите кнопку "Сохранить", чтобы сохранить конвейер. Выберите "Выполнить" , чтобы запустить его напрямую или запланировать выполнение в определенный момент времени или интервалы. Дополнительные сведения о запусках конвейера см. в статье "Планирование запусков конвейера".
После выполнения можно отслеживать выполнение конвейера и просматривать журнал выполнения с вкладки "Выходные данные " под холстом.
Пример: сбой условного конвейера
Ниже приведен распространенный шаблон сбоя конвейера на основе пользовательских условий:
- Использование действия If Condition для оценки пользовательского условия ошибки
- В ветви True условия If добавьте действие Fail
- Настройте действие fail с пользовательским сообщением об ошибке, описывающее конкретное условие, которое было выполнено
- В ветви False продолжайте обычное выполнение конвейера.
Этот шаблон позволяет конвейеру корректно завершать работу, со значимыми сообщениями об ошибках, когда обнаруживаются определенные условия бизнес-логики или данных.