Compartir vía

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 Fail en el lienzo si aún no está seleccionada y su pestaña Configuración para editar sus detalles.

    Muestra la UI de la actividad de error.

  3. Escriba un mensaje y un código de error. Estos valores pueden ser expresiones de cadena literales o cualquier combinación de expresiones dinámicas, funciones, 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 que se va a evaluar en tiempo de ejecución. Cadena Sí
errorCode Código de error que clasifica el tipo de error de la actividad Fail. Puede ser contenido dinámico que se va a evaluar en tiempo de ejecución. Cadena Sí

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

Normalmente, los autores de canalizaciones establecen el mensaje de error y el código de error de la 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 El 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. "<activity_name> parámetro de mensaje de error no se pudo interpretar como una cadena" El 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>" El 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" El 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: