Tarea Script

  • Artículo

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

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. Actualmente no se admiten las referencias de ensamblado de .NET Core ni de .NET Standard.

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 evento ScriptTaskLogEntry se selecciona para su registro en la pestaña Detalles del cuadro de diálogo Configurar registros de SSIS . Para más información, consulte Registro de Integration Services (SSIS).

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:

Editor de la tarea Script (página General)

Utilice la página General del cuadro de diálogo Editor de la tarea Script para asignar un nombre a la tarea Script y describirla.

Para obtener más información acerca de la tarea Script, vea Script Task y Configurar la tarea Script en el editor de la tarea Script. Para obtener información sobre cómo programar la tarea Script, vea Extending the Package with the Script Task.

Opciones

Nombre
Proporcione un nombre único para la tarea Script. Este nombre se utiliza como etiqueta en el icono de tarea.

Nota

Los nombres de tarea deben ser únicos en un paquete.

Descripción
Escriba una descripción de la tarea Script.

Editor de la tarea Script (página Script)

Use la página Script del cuadro de diálogo Editor de la tarea Script para establecer las propiedades del script y para especificar las variables a las que se puede tener acceso desde el mismo.

Nota:

En SQL Server 2008 Integration Services (SSIS) y versiones posteriores, se recompilan todos los scripts. En versiones anteriores, se establece una propiedad PrecompileScriptIntoBinaryCode para especificar que se precompiló el script.

Para obtener más información acerca de la tarea Script, vea Script Task y Configurar la tarea Script en el editor de la tarea Script. Para obtener información sobre cómo programar la tarea Script, vea Extending the Package with the Script Task.

Opciones

Lenguaje de script
Seleccione el lenguaje de scripting para la tarea, Microsoft Visual Basic o Microsoft Visual C#.

Una vez haya creado un script para la tarea, no podrá cambiar el valor de la propiedad ScriptLanguage .

Para establecer el lenguaje de scripting predeterminado para la tarea Script, utilice la opción Lenguaje de scripting en la página General del cuadro de diálogo Opciones . Para obtener más información, vea General Page.

EntryPoint
Especifique el método que el tiempo de ejecución de Integration Services llama como punto de entrada en el código de la tarea Script. El método especificado debe estar en la clase ScriptMain del proyecto de Microsoft Visual Studio Tools for Applications (VSTA). La clase ScriptMain es la clase predeterminada que las plantillas del script generan.

Si cambia el nombre del método en el proyecto VSTA, deberá cambiar el valor de la propiedad EntryPoint .

Variables de solo lectura
Escriba una lista separada por comas de variables de solo lectura que estén disponibles para el script, o bien haga clic en el botón de puntos suspensivos (…) y seleccione las variables en el cuadro de diálogo Seleccionar variables.

Nota:

Los nombres de variables distinguen entre mayúsculas y minúsculas.

Variables de lectura/escritura
Escriba una lista separada por comas de variables de lectura y escritura que estén disponibles para el script, o bien haga clic en el botón de puntos suspensivos (…) y seleccione las variables en el cuadro de diálogo Seleccionar variables.

Nota:

Los nombres de variables distinguen entre mayúsculas y minúsculas.

Editar script
Abre la VSTA IDE donde puede crear o modificar el script.

Contenido relacionado