Controladores de eventos de Integration Services (SSIS)

En el tiempo de ejecución, los ejecutables (paquetes y contenedores de bucles Foreach, bucles For, de secuencia y de host de tarea) producen eventos. Por ejemplo un evento OnError se produce cuando se genera un error. Puede crear controladores de eventos personalizados para estos eventos con el fin de ampliar la funcionalidad de paquetes y facilitar la administración de paquetes en el tiempo de ejecución. Los controladores de eventos pueden realizar tareas tales como las siguientes:

• Limpiar un almacén temporal de datos cuando un paquete o tarea termina de ejecutarse.

• Recuperar la información de sistema para evaluar la disponibilidad de los recursos antes de que el paquete se ejecute.

• Actualizar datos en una tabla cuando se produce un error en una búsqueda en una tabla de referencia.

• Enviar un mensaje de correo electrónico cuando se produce un error o una advertencia, o cuando se genera un error en una tarea.

Si un evento no tiene controlador de eventos, el evento se desencadena en el siguiente contenedor en sentido ascendente en la jerarquía de contenedores en un paquete. Si este contenedor tiene un controlador de eventos, éste se ejecuta en respuesta al evento. En caso contrario, el evento se desencadena en el siguiente contenedor en sentido ascendente en la jerarquía de contenedores.

El diagrama siguiente muestra un paquete simple que tiene un contenedor de bucles For que contiene una tarea Ejecutar SQL.

Solo el paquete tiene un controlador de eventos, para su evento OnError. Si se produce un error cuando se ejecuta una tarea Ejecutar SQL, se ejecuta el controlador de eventos OnError para el paquete. El siguiente diagrama muestra la secuencia de llamadas que produce el controlador de eventos OnError para que se ejecute el paquete.

Los controladores de eventos son miembros de una colección de controladores de eventos y todos los contenedores incluyen esta colección. Si crea el paquete mediante el Diseñador SSIS, puede ver los miembros de las colecciones de controladores de eventos en las carpetas Controladores de eventos en la pestaña Explorador de paquetes del Diseñador SSIS.

Puede configurar el contenedor del controlador de eventos de las maneras siguientes:

• Especifique un nombre y una descripción para el controlador de eventos.

• Indique si se ejecuta el controlador de eventos, si se produce un error en el paquete cuando se produce un error en el controlador de eventos, y la cantidad de errores que se pueden producir antes de que se produzca un error en el controlador de eventos.

• Especifique un resultado de ejecución que se debe devolver en lugar del resultado de ejecución real que el controlador de eventos devuelve en el tiempo de ejecución.

• Especifique la opción de transacción para el controlador de eventos.

• Especifique el modo de registro que usa el controlador de eventos.

Contenido del controlador de eventos

Crear un controlador de eventos es similar a generar un paquete. Un controlador de eventos tiene tareas y contenedores, que se ordenan en un flujo de control, y un controlador de eventos también puede incluir flujos de datos. El Diseñador SSIS incluye la pestaña Controladores de eventos para crear controladores de eventos personalizados. Para obtener más información, vea Controladores de eventos de Integration Services (SSIS).

También se pueden crear controladores de eventos mediante programación. Para obtener más información, vea Controlar eventos mediante programación.

Eventos de tiempo de ejecución

En la siguiente tabla se enumeran los controladores de eventos que proporciona Integration Services y se describen los eventos de tiempo de ejecución que hacen que el controlador de eventos se ejecute.

Controlador de eventos	Evento
OnError	El controlador de eventos para el evento OnError. Este evento es desencadenado por un ejecutable cuando se produce un error.
OnExecStatusChanged	El controlador de eventos para el evento OnExecStatusChanged. Este evento es desencadenado por un ejecutable cuando se modifica su estado de ejecución.
OnInformation	El controlador de eventos para el evento OnInformation. Este evento se desencadena durante la validación y ejecución de un ejecutable para proporcionar información. Este evento transmite únicamente información, no errores o advertencias.
OnPostExecute	El controlador de eventos para el evento OnPostExecute. Este evento es desencadenado por un ejecutable inmediatamente después de haber terminado de ejecutarse.
OnPostValidate	El controlador de eventos para el evento OnPostValidate. Este evento es desencadenado por un ejecutable cuando termina su validación.
OnPreExecute	El controlador de eventos para el evento OnPreExecute. Este evento es desencadenado por un ejecutable inmediatamente antes de que se ejecuta.
OnPreValidate	El controlador de eventos para el evento OnPreValidate. Este evento es desencadenado por un ejecutable cuando se inicia su validación.
OnProgress	El controlador de eventos para el evento OnProgress. Este evento es desencadenado por un ejecutable cuando el ejecutable realiza un progreso que se puede medir.
OnQueryCancel	El controlador de eventos para el evento OnQueryCancel. Este evento es desencadenado por un ejecutable para determinar si debe dejar de ejecutarse.
OnTaskFailed	El controlador de eventos para el evento OnTaskFailed. Este evento es desencadenado por una tarea cuando se produce un error.
OnVariableValueChanged	El controlador de eventos para el evento OnVariableValueChanged. Este evento es desencadenado por un ejecutable cuando se modifica el valor de una variable. El evento es desencadenado por el ejecutable en el que se define la variable. Este evento no se desencadena si establece la propiedad RaiseChangeEvent de la variable en False. Para obtener más información, vea Variables de Integration Services (SSIS).
OnWarning	El controlador de eventos para el evento OnWarning. Este evento es desencadenado por un ejecutable cuando se produce una advertencia.

Configuración de un controlador de eventos

Puede establecer propiedades en la ventana Propiedades de SQL Server Data Tools (SSDT) o mediante programación.

Para obtener información acerca de cómo establecer estas propiedades en SQL Server Data Tools (SSDT), vea Establecer las propiedades de tareas o contenedores.

Para obtener información sobre cómo establecer mediante programación estas propiedades, vea DtsEventHandler.

Tareas relacionadas

Para obtener información sobre cómo agregar un controlador de eventos a un paquete, vea agregar un controlador de eventos a un paquete.

Contenido relacionado

Mantenerse al día con Integration Services Para obtener las descargas, los artículos, los ejemplos y los vídeos más recientes de Microsoft, así como una selección de soluciones de la comunidad, visite la página de Integration Services en MSDN: Visite la página de Integration Services en MSDN Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.