Contenedor Foreach Loop

El contenedor de bucles Foreach define un flujo de control que se repite en un paquete. La implementación del bucle es similar a la estructura de bucle Foreach de los lenguajes de programación. En un paquete, los bucles se habilitan mediante un enumerador Foreach. El contenedor de bucles Foreach repite el flujo de control para cada miembro de un enumerador especificado.

SQL Server 2005 Integration Services (SSIS) proporciona los siguientes tipos de enumerador:

• Enumerador de ADO para Foreach, para enumerar filas de tablas. Por ejemplo, puede obtener las filas de un conjunto de registros ADO.
• Enumerador de conjunto de filas del esquema para Foreach de ADO.NET, para enumerar la información de esquema sobre un origen de datos. Por ejemplo, puede enumerar y obtener una lista de tablas de la base de datos AdventureWorks de SQL Server.
• Enumerador Foreach File para enumerar los archivos de una carpeta. El enumerador puede recorrer subcarpetas. Por ejemplo, puede leer todos los archivos de la carpeta y subcarpetas de Windows que tengan la extensión de nombre de archivo *.log.
• Enumerador de variable para Foreach, para enumerar el objeto enumerable contenido en una variable especificada. El objeto enumerable puede ser una matriz, una DataTable ADO.NET, un enumerador Integration Services, etc. Por ejemplo, puede enumerar los valores de una matriz que contenga los nombres de los servidores.
• Enumerador de elementos para Foreach para enumerar elementos que son colecciones. Por ejemplo, puede enumerar los nombres de los ejecutables y directorios de trabajo que utiliza una tarea Ejecutar proceso.
• Enumerador de lista de nodos para Foreach para enumerar el conjunto de resultados de una expresión del Lenguaje de rutas XML (XPath). Por ejemplo, esta expresión enumera y obtiene una lista de todos los autores de la época clásica:
• Enumerador de SMO para Foreach para enumerar objetos de Objetos de administración de SQL Server(SMO). Por ejemplo, puede enumerar y obtener una lista de vistas de una base de datos de SQL Server.

El siguiente diagrama muestra un contenedor de bucles Foreach que tiene una tarea Sistema de archivos. El bucle Foreach utiliza el Enumerador de archivos para Foreach y la tarea Sistema de archivos está configurada para copiar un archivo. Si la carpeta especificada por el enumerador contiene cuatro archivos, el bucle se repetirá cuatro veces y copiará cuatro archivos.

Puede utilizar una combinación de variables y expresiones de propiedades para actualizar la propiedad del objeto de paquete con el valor de colección de enumerador. Primero debe asignar el valor de colección a una variable definida por el usuario y después debe implementar una expresión de propiedad en la propiedad que utiliza la variable. Por ejemplo, el valor de colección del Enumerador de archivos para Foreach se asigna a una variable denominada MyFile y se usa la variable en la expresión de propiedad para la propiedad Subject de una tarea Enviar correo. Cuando se ejecuta el paquete, la propiedad Subject se actualiza con el nombre de un archivo cada vez que se repite el bucle. Para obtener más información, vea Usar expresiones de propiedad en paquetes.

Las variables asignadas al valor de colección del enumerador también se pueden usar en expresiones y en secuencias de comandos.

Un contenedor de bucles Foreach puede incluir varias tareas y contenedores, pero sólo puede usar un tipo de enumerador. Si el contenedor de bucles Foreach incluye varias tareas, puede asignar el valor de colección del enumerador a varias propiedades de cada tarea.

Puede establecer un atributo de transacción en el contenedor de bucles Foreach para definir una transacción para un subconjunto del flujo de control del paquete. De esta manera, puede administrar las transacciones en el nivel del contenedor de bucles Foreach en lugar de hacerlo en el nivel de paquete. Por ejemplo, si un contenedor de bucles Foreach repite un flujo de control que actualiza las dimensiones y las tablas de hechos de un esquema de estrella, puede configurar una transacción para asegurarse de que o se actualizan todas las tablas de hechos correctamente o no se actualiza ninguna. Para obtener más información, vea Incorporar transacciones en paquetes.

Tipos de enumerador

Los enumeradores son configurables. Deberá proporcionar información diferente en función del enumerador.

En la tabla siguiente se resume la información requerida por cada tipo de enumerador.

Usar expresiones de propiedad en contenedores de bucles Foreach

Se puede configurar que los paquetes ejecuten varios ejecutables simultáneamente. Esta configuración se debe utilizar con precaución cuando el paquete incluye un contenedor de bucles Foreach que implementa expresiones de propiedad.

A menudo es útil implementar una expresión de propiedad para establecer el valor de la propiedad ConnectionString de los administradores de conexión que utilizan los enumeradores de bucle Foreach. La expresión de propiedad de ConnectionString se establece a través de una variable que se asigna al valor de colección del enumerador y se actualiza en cada iteración del bucle.

Para evitar consecuencias negativas de tiempos no determinativos en la ejecución paralela de tareas en el bucle, se debe configurar el paquete para que ejecute sólo un ejecutable a la vez. Por ejemplo, si un paquete puede ejecutar varias tareas simultáneamente, un contenedor de bucles Foreach que enumera archivos en la carpeta, recupera los nombres de los archivos y luego utiliza una tarea Ejecutar SQL para insertar los nombres de archivos en una tabla puede incurrir en conflictos de escritura cuando dos instancias de la tarea Ejecutar SQL intentan escribir al mismo tiempo. Para obtener más información, vea Usar expresiones de propiedad en paquetes.

Configurar el contenedor de bucles Foreach

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

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:

• Editor de bucles Foreach (página General)
• Editor de bucles Foreach (página Colección)
• Editor de bucles Foreach (página Asignaciones de variables)
• Página Expresiones

Para obtener más información sobre cómo establecer estas propiedades en el Diseñador SSIS, haga clic en uno de los temas siguientes:

• Cómo configurar un contenedor de bucles Foreach
• Cómo establecer las propiedades de los contenedores

Configurar el contenedor de bucles Foreach mediante programación

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

• ForEachLoop

Vea también

Conceptos

Crear un flujo de control de paquetes
Contenedores de Integration Services

Ayuda e información

Obtener ayuda sobre SQL Server 2005

Historial de cambios