Compartir a través de

Tarea Script

  • Artículo

La tarea Script proporciona código para realizar funciones que no están disponibles en las tareas integradas ni en las transformaciones proporcionadas por SQL Server Integration Services. La tarea Script también puede combinar funciones en un script, en lugar de usar múltiples tareas y transformaciones. La tarea Script sirve para trabajos que se deben realizar una sola vez en un paquete (o una vez por objeto enumerado), en lugar de una vez por fila de datos.

Puede usar la tarea Script para los siguientes fines:

  • Tener acceso a datos mediante otras tecnologías incompatibles con los tipos de conexión integrados. Por ejemplo, un script puede usar interfaces del servicio Active Directory (ADSI) para tener acceso a los nombres de usuario de Active Directory y extraer dichos nombres.

  • Crear un contador de rendimiento específico del paquete. Por ejemplo, un script puede crear un contador de rendimiento que se actualiza mientras se ejecuta una tarea compleja o de bajo rendimiento.

  • Identificar si archivos específicos están vacíos o cuántas filas contienen y luego, en función de esa información, afectar el flujo de control de un paquete. Por ejemplo, si un archivo contiene cero filas, el valor de una variable se establece en 0, y una restricción de precedencia que evalúa el valor impide que una tarea Sistema de archivos copie el archivo.

Si tiene que utilizar el script para hacer el mismo trabajo en cada fila de datos de un conjunto, utilice el componente de script de la tarea Script. Por ejemplo, si desea evaluar si un valor de franqueo es razonable y omitir filas de datos con valores extremadamente altos o bajos, utilice un componente de script. Para más información, consulte Script Component.

Si varios paquetes usan el script, considere la posibilidad de escribir una tarea personalizada en lugar de usar la tarea Script. Para más información, vea Desarrollar una tarea personalizada.

Una vez que haya decidido que la tarea Script es la opción adecuada para el paquete, tiene que desarrollar el script que la tarea utiliza y configurar la propia tarea.

Escribir y ejecutar el script que la tarea utiliza

La tarea Script usa Microsoft Visual Studio Tools para Aplicaciones (VSTA) como entorno de escritura de los scripts y como motor que los ejecuta.

VSTA proporciona todas las características estándar del entorno Visual Studio , como el editor de Visual Studio con códigos de color, IntelliSense y el Explorador de objetos. VSTA también utiliza el mismo depurador que usan otras herramientas de desarrollo de Microsoft . Los puntos de interrupción del script funcionan a la perfección con los puntos de interrupción de las tareas y los contenedores de Integration Services . VSTA es compatible con los lenguajes de programación Microsoft Visual Basic y Microsoft Visual C#.

Para ejecutar un script, debe tener VSTA instalado en el equipo en que se ejecute el paquete. Al ejecutar el paquete, la tarea carga el motor de script y ejecuta el script. Puede tener acceso a ensamblados .NET externos en scripts; para ello, debe agregar referencias a dichos ensamblados en el proyecto.

Nota:

A diferencia de las versiones anteriores en las que podía indicar si se precompilaban los scripts, todos los scripts se precompilan en SQL Server 2008 Integration Services (SSIS) y versiones posteriores. Al precompilar el script, no se carga el motor del lenguaje en tiempo de ejecución, por lo que el paquete se ejecuta con mayor rapidez. Sin embargo, los archivos binarios precompilados utilizan una cantidad considerable de espacio en disco.

Configurar la tarea Script

Puede configurar la tarea Script de las maneras siguientes:

  • Proporcionar el script personalizado que ejecuta la tarea.

  • Especifique el método del proyecto de VSTA que el módulo de ejecución de Integration Services llama como punto de entrada en el código de la tarea Script.

  • Especificar el lenguaje de script.

  • Opcionalmente, proporcionar listas de variables de solo lectura/lectura y escritura para su uso en el script.

Puede establecer estas propiedades a través del Diseñador SSIS o mediante programación.

Configurar la tarea Script en el Diseñador

En la tabla siguiente se describe el evento ScriptTaskLogEntry que se puede registrar para la tarea Script. El ScriptTaskLogEntry evento está seleccionado para iniciar sesión en la pestaña Detalles del cuadro de diálogo Configurar registros de SSIS . Para obtener más información, consulte Registro de Integration Services (SSIS) y Mensajes personalizados para el registro.

Entrada del registro Descripción
ScriptTaskLogEntry Informa sobre los resultados de la implementación del registro en el script. La tarea escribe una entrada del registro para cada llamada al método Log del objeto Dts. La tarea escribe estas entradas cuando se ejecuta el código. Para más información, consulte Logging in the Script Task.

Para obtener más información acerca de las propiedades que puede establecer en el Diseñador SSIS , vea los temas siguientes:

Para obtener más información sobre cómo establecer estas propiedades en el Diseñador SSIS , vea el siguiente tema:

Configurar la tarea Script mediante programación

Para obtener más información sobre cómo establecer estas propiedades mediante programación, vea el tema siguiente:

Contenido relacionado