Transformación de datos con una actividad ForEach
La actividad ForEach define un flujo de control repetido en la canalización de Microsoft Fabric. Esta actividad se usa para iterar una colección y ejecuta las actividades especificadas en un bucle. La implementación del bucle de esta actividad es similar a la estructura de un bucle ForEach de los lenguajes de programación.
Adición de una actividad ForEach a una canalización
En esta sección se describe cómo usar una actividad ForEach en una canalización.
Requisitos previos
Para empezar, debe completar los siguientes requisitos previos:
- Una cuenta de inquilino con una suscripción activa. Cree una cuenta gratuita.
- Se crea un área de trabajo.
Creación de la actividad
Cree una canalización en el área de trabajo.
Busque ForEach en el panel de canalización Actividades y selecciónela para añadirla al lienzo de la canalización. Si no puede verla inicialmente, use la flecha del lado derecho de la barra de herramientas de actividades para desplazarse a la derecha para encontrarlo.
Seleccione la nueva actividad de ForEach en el lienzo si aún no está seleccionada.
En la pestaña General de la parte inferior del lienzo, escriba un nombre para la actividad en la propiedad Name.
(Opcional) También puede escribir una descripción.
Configuración de ForEach
Seleccione la pestaña Configuración, donde puede especificar si el procesamiento de los elementos del lote debe ser Secuencial (o en caso contrario en paralelo). También puede especificar un número máximo de elementos que se van a procesar al mismo tiempo con el recuento de Batch. Por último, debe especificar una lista de elementos delimitados por comas, que se pueden parametrizar o incluir contenido dinámico. Agregue algunos elementos a la lista de Elementos como se muestra en el ejemplo.
Actividades de ForEach
También definirá una actividad o actividades que se realizarán en cada uno de los elementos de la lista, en el panel Actividades de ForEach.
Seleccione el botón + para agregar una nueva actividad al panel. Verá una lista de actividades que elegir. Puede agregar varias actividades a la actividad ForEach y cada una se ejecuta en cada uno de los elementos de la lista Elementos. Si la opción Secuencial está seleccionada en la configuración de ForEach o no, cada una de las actividades secundarias del panel de actividades ForEach se procesa secuencialmente entre sí para cada elemento. Sin embargo, si Secuencial no está seleccionado, se procesan varios elementos en paralelo, cada uno de ellos se ejecuta secuencialmente a través de la lista de actividades secundarias especificadas.
Hacer referencia a un elemento dentro de una actividad
Seleccione una de las actividades secundarias en el panel Actividades de ForEach y cambie a su pestaña Configuración. En este ejemplo, se seleccionó una actividad Procedimiento almacenado. Rellene la configuración de la actividad como normalmente seleccionaría una conexión y un procedimiento almacenado. Puede usar el iterador @item() para hacer referencia al elemento actual que se está procesando en cualquier parte de una actividad que admita contenido dinámico. Aquí se usó el @item() como valor para el parámetro FruitName que se pasa a un procedimiento almacenado.
