Componente de script

El componente de script hospeda el script y permite a un paquete incluir y ejecutar código personalizado de script. Puede usar el componente de script en paquetes para los siguientes fines:

  • Aplicar varias transformaciones a los datos en lugar de usar varias transformaciones en el flujo de datos. Por ejemplo, un script puede sumar los valores de dos columnas y luego calcular el promedio de la suma.

  • Tener acceso a las reglas de negocios en un ensamblado .NET existente. Por ejemplo, un script puede aplicar una norma empresarial que especifica el intervalo de valores que son válidos en la columna Income.

  • Usar fórmulas personalizadas y funciones, además de las funciones y operadores que proporciona la gramática de la expresión Integration Services. Por ejemplo, validar números de tarjeta de crédito mediante la fórmula LUHN.

  • Validar datos de columna y omitir registros que contienen datos no válidos. Por ejemplo, un script puede evaluar si un valor de franqueo es razonable y omitir registros con valores extremadamente altos o bajos.

El componente de script proporciona una manera fácil y rápida de incluir funciones personalizadas en un flujo de datos. Sin embargo, si planea reutilizar el código de script en varios paquetes, quizás resulte más conveniente programar un componente personalizado en lugar de usar el componente de script. Para obtener más información, vea Desarrollar un componente de flujo de datos personalizado.

Nota

Si el componente de script contiene un script que intenta leer el valor de una columna que es NULL, se produce un error en el componente de script al ejecutar el paquete. Es recomendable que el script utilice el método IsNull para determinar si la columna es NULL antes de intentar leer el valor de la columna.

El componente de script se puede usar como origen, transformación o destino. Este componente admite una entrada y varias salidas. Según la forma en que se usa el componente, admite una entrada o salidas, o ambas cosas. El script es invocado por cada fila en la entrada o la salida.

  • Si se usa como origen, el componente de script admite varias salidas.

  • Si se usa como transformación, el componente de script admite una entrada y varias salidas.

  • Si se usa como destino, el componente de script admite una entrada.

El componente de script no admite salidas de error.

Una vez que haya decidido que el componente de script es la opción adecuada para su paquete, tiene que configurar las entradas y salidas, desarrollar el script que el componente utiliza y configurar el propio componente.

Descripción de los modos del componente de script

En el Diseñador SSIS, el componente de script tiene dos modos: modo de diseño de metadatos y modo de diseño de código. En el modo de diseño de metadatos, se pueden agregar y modificar las entradas y salidas de componente de script, pero no se puede escribir código. Una vez configuradas todas las entradas y salidas, se cambia al modo de diseño de código para escribir el script. El componente de script genera automáticamente código base a partir de los metadatos de entradas y salidas. Si cambia los metadatos después de que el componente de script genere el código de base, es posible que su código ya no pueda compilarse porque el código base actualizado puede ser incompatible con su código.

Escribir el script que el componente utiliza

El componente de script utiliza Microsoft Visual Studio Tools para aplicaciones (VSTA) como entorno para escribir los scripts. Puede tener acceso a VSTA en el Editor de transformación Script. Para obtener más información, vea Editor de transformación Script (página Script).

El componente de script proporciona un proyecto de VSTA que incluye una clase autogenerada, llamada ScriptMain, que representa los metadatos del componente. Por ejemplo, si el componente de script se usa como una transformación que tiene tres salidas, ScriptMain incluye un método para cada salida. ScriptMain es el punto de entrada al script.

VSTA incluye 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. El script que usa el componente de script se almacena en la definición de paquete. Al diseñar el paquete, el código de script se escribe temporalmente en un archivo de proyecto.

VSTA admite los lenguajes de programación Microsoft Visual Basic 2008 y Microsoft Visual C# 2008.

Para obtener información acerca de cómo programar el componente de script, vea Ampliar el flujo de datos con el componente de script. Para obtener información más específica acerca de cómo configurar el componente de script como origen, transformación o destino, vea Desarrollar tipos específicos de los componentes de script. Para consultar ejemplos adicionales, como un destino ODBC, que ilustran el uso del componente de script, vea Ejemplos de componente de script adicionales.

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 el componente de script

Puede configurar el componente de script de las maneras siguientes:

  • Seleccionar las columnas de entrada a las que hacer referencia.

    Nota

    Puede configurar solo una entrada al utilizar el Diseñador de SSIS.

  • Proporcionar el script que ejecuta el componente.

  • Especificar el lenguaje de script.

  • Proporcionar listas separadas por comas de variables de solo lectura y de lectura/escritura.

  • Agregue más salidas, así como columnas de salida en las que el script realiza asignaciones.

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

Configurar el componente de script en el Diseñador

Para obtener más información sobre las propiedades que se pueden establecer en el cuadro de diálogo Editor de transformación Script, haga clic en uno de los siguientes temas:

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

Configurar el componente de script mediante programación

Para obtener más información sobre las propiedades que se pueden establecer en la ventana Propiedades o mediante programación, haga clic en uno de los siguientes temas:

Para obtener más información sobre cómo establecer valores de propiedades, haga clic en uno de los temas siguientes:

Icono de Integration Services (pequeño) Manténgase al día con Integration Services

Para obtener las más recientes descargas, artículos, ejemplos y vídeos de Microsoft, así como soluciones seleccionadas de la comunidad, visite la página de Integration Services en MSDN o TechNet:

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