Compartir a través de

Ejecución de la actividad Fail en Azure Data Factory y Synapse Analytics

  • Artículo

En ocasiones, es posible que quiera producir un error en una canalización intencionadamente. Por ello, es posible que una actividad de búsqueda no devuelva datos coincidentes, o que una actividad personalizada termine con un error interno. Sea cual sea el motivo, ahora puede usar una actividad Fail en una canalización y personalizar el código y el mensaje de error.

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Pruebe Data Factory en Microsoft Fabric, una solución de análisis todo en uno para empresas. Microsoft Fabric abarca todo, desde el movimiento de datos hasta la ciencia de datos, el análisis en tiempo real, la inteligencia empresarial y los informes. Obtenga información sobre cómo iniciar una nueva evaluación gratuita.

Creación de una actividad de error con la UI

Para usar una actividad de error en una canalización, complete los pasos siguientes:

  1. Busque error en el panel Actividades de canalización y arrastre una actividad de error al lienzo de canalización.

  2. Seleccione la nueva actividad de error en el lienzo si aún no está seleccionada y su pestaña Configuración para editar sus detalles.

    Shows the UI for a Fail activity.

  3. Escriba un mensaje y un código de error. Pueden ser expresiones de cadena literales o cualquier combinación de expresiones y funciones dinámicas, variables del sistema o salidas de otras actividades.

Sintaxis

{
    "name": "MyFailActivity",
    "type": "Fail",
    "typeProperties": {
        "errorCode": "500",
        "message": "My Custom Error Message"
    }
}

Propiedades de tipo

Propiedad Descripción Valores permitidos Obligatorio
name Nombre de la actividad Fail. String Sí
type Debe establecerse en Fail. String Sí
message Mensaje de error que aparece en la actividad de error. Puede ser contenido dinámico evaluado en tiempo de ejecución. String Sí
errorCode Código de error que clasifica el tipo de error de la actividad Fail. Puede ser contenido dinámico evaluado en tiempo de ejecución. String Sí

Descripción del código de error la actividad Fail

Normalmente, los usuarios establecen el mensaje y el código de error de una actividad Fail. Póngase en contacto con el desarrollador de las canalizaciones para comprender los significados específicos de los códigos de error. Sin embargo, en los siguientes casos perimetrales, es la instancia de Azure Data Factory la que establece el mensaje o el código de error.

Descripción de la situación Mensaje de error Código de error
El contenido (dinámico) en message y errorCode se ha interpretado correctamente. Mensaje de error establecido por el usuario Código de error establecido por el usuario
El contenido dinámico de message y errorCode no se puede interpretar. "No se puede interpretar el mensaje o el código de error de <nombre_de_actividad>" ErrorCodeNotString
El contenido dinámico de message no se puede interpretar como una cadena. "El parámetro del mensaje de error de <nombre_de_actividad> no se puede interpretar como una cadena" Código de error establecido por el usuario
El contenido dinámico de message se resuelve en NULL, una cadena vacía o espacios en blanco. "No se puede interpretar el mensaje o el código de error de <nombre_de_actividad>" Código de error establecido por el usuario
El contenido dinámico de errorCode no se puede interpretar como una cadena. Mensaje de error establecido por el usuario ErrorCodeNotString
El contenido dinámico de errorCode se resuelve en NULL, una cadena vacía o espacios en blanco. Mensaje de error establecido por el usuario ErrorCodeNotString
El valor de message o errorCode proporcionado por el usuario no se puede convertir en cadena.* Se produce un error en la canalización con: "Valor no válido para la propiedad <errorCode/message>"
Falta el campo message.* "No se proporcionó el mensaje de error" Código de error establecido por el usuario
Falta el campo errorCode.* Mensaje de error establecido por el usuario ErrorCodeNotString

* Esta situación no debería producirse si la canalización se desarrolla con la interfaz de usuario web (UI) de Data Factory.

Contenido relacionado

Consulte otras actividades de flujo de control admitidas, incluidas las siguientes: