• Artículo

Tarea Script

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 obtener más información, vea Componente de script.

Si varios paquetes usan el script, considere la posibilidad de escribir una tarea personalizada en lugar de usar la tarea Script. Para obtener 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 utiliza Microsoft Visual Studio Tools para Aplicaciones (VSTA) como entorno de escritura de los scripts y el 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 admite los lenguajes de programación Microsoft Visual Basic 2008 y Microsoft Visual C# 2008.

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). 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 evento ScriptTaskLogEntry se selecciona para su registro en la ficha Detalles del cuadro de diálogo Configurar registros de SSIS. Para obtener más información, vea Implementar inicios de sesión en paquetes y Mensajes personalizados para 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 obtener más información, vea Registrar en la tarea Script.

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

Para obtener más información sobre cómo establecer estas propiedades en el Diseñador SSIS, haga clic en 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, haga clic en el tema siguiente:

Recursos externos

Icono de Integration Services (pequeño) Manténgase 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:

Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.