Flujos de trabajo avanzados (Diseñador visual de flujos de trabajo)

Descripción

Un flujo de trabajo avanzado se ejecuta en un lienzo visual, el Diseñador visual de flujos de trabajo, donde los pasos son nodos de un grafo dirigido (un DAG). Las líneas entre los nodos muestran cómo fluyen los datos, y el motor de ejecución los ejecuta en orden de dependencia en lugar de de arriba abajo. Las ramas que no dependen entre sí se ejecutan en paralelo automáticamente.

Avanzado es uno de los tipos de flujo de trabajo de PlaidCloud; el otro es Estándar. Las funciones de esta guía (el lienzo visual, los puntos de interrupción, los contenedores, Ejecutar desde aquí, Simular y el Inspector acoplado) son exclusivas del tipo Avanzado. El lienzo también admite la colaboración en tiempo real: varias personas pueden abrir el mismo flujo de trabajo avanzado y editarlo juntas, viendo en directo la presencia y los cambios de las demás.

Estándar frente a Avanzado

Cada flujo de trabajo tiene un tipo, que se elige al crearlo:

Tipo	Los pasos se organizan en…	…y se ejecutan
Estándar en serie	la lista de pasos	de arriba abajo, uno a la vez
Estándar en paralelo	la lista de pasos	desde la lista, en paralelo cuando las dependencias lo permiten
Avanzado (lienzo DAG)	un grafo visual de nodos y conexiones	en orden de dependencia: las ramas independientes se ejecutan en paralelo automáticamente

Estándar y Avanzado se ejecutan en motores diferentes: un flujo de trabajo estándar se ejecuta desde su lista de pasos, mientras que un flujo de trabajo avanzado se ejecuta desde el grafo que usted dibuja, siguiendo las conexiones explícitas de productor y consumidor entre los pasos. Por eso el Diseñador visual de flujos de trabajo solo se abre para los flujos de trabajo avanzados: las flechas dibujadas en un flujo de trabajo estándar no cambiarían cómo se ejecuta.

Elegir el tipo de flujo de trabajo

Puede establecer el tipo al crear un flujo de trabajo, o convertir un flujo de trabajo estándar existente:

Al crearlo: el selector de tipo de flujo de trabajo ofrece Estándar en serie, Estándar en paralelo, Avanzado (lienzo DAG) y Macro (próximamente). Los flujos de trabajo nuevos son Estándar en serie de forma predeterminada.
Convertir un flujo de trabajo existente: seleccione un flujo de trabajo estándar en la lista Flujos de trabajo, elija Convertir a avanzado… y confirme. Sus pasos, su configuración y sus dependencias se conservan; solo cambia cómo se muestra y se ejecuta el flujo de trabajo.

Cambiar el tipo de un flujo de trabajo de Estándar a Avanzado mediante la API REST o un asistente de IA conserva el orden de los pasos del mismo modo que Convertir a avanzado…. Se rechaza cambiar un flujo de trabajo avanzado de nuevo a Estándar.

El lienzo

Cada paso es un nodo, y las conexiones entre los nodos definen el orden en que se ejecutan los pasos. El Diseñador organiza los pasos automáticamente, y usted puede reorganizarlos libremente.

Quién está aquí

Cuando más de una persona tiene abierto el mismo flujo de trabajo avanzado, aparece una fila de avatares en la barra de herramientas del lienzo que muestra quién más lo está viendo o editando, con la misma idea de presencia en directo de un documento compartido. Cada persona se muestra con su gravatar (o con sus iniciales si no tiene uno), y al pasar el puntero sobre un avatar se muestra su nombre. Una persona aparece una sola vez sin importar en cuántas pestañas del navegador tenga abierto el flujo de trabajo, y cuando hay más espectadores de los que caben, los adicionales se contraen en un marcador +N.

Mosaicos de pasos

Cada mosaico resume su paso de un vistazo, de arriba abajo:

Encabezado: el icono y el nombre del tipo de paso, además de un icono de estado que muestra el resultado de la última ejecución del paso.
Entradas: un icono por cada tabla, dimensión o archivo que lee el paso. Haga clic en el icono de una tabla para obtener una vista previa en el cajón de vista previa de datos, en el icono de una dimensión para abrir la dimensión, o en el icono de un archivo para descargarlo. Un paso con muchas entradas o salidas contrae las adicionales en un marcador +N.
Nombre del paso: centrado en el cuerpo del mosaico.
Salidas: iconos de las salidas del paso, con el mismo comportamiento al hacer clic. Una vez que existe la tabla de salida, esta fila también muestra sus recuentos de filas y columnas (por ejemplo, 12,345 rows · 8 cols), los mismos Filas y Columnas que se muestran en las tablas de entradas y salidas del paso, de modo que puede ver cómo se mueven los volúmenes de datos por el flujo de trabajo sin abrir cada tabla. Hasta entonces (o cuando el paso genera un archivo o una dimensión en su lugar), la fila muestra una etiqueta Salidas simple. Pase el puntero sobre cualquier icono de tabla para ver su nombre y sus recuentos.
Pie: las duraciones de la última ejecución y la media del paso, con un tinte cuando la última ejecución fue inusualmente lenta en comparación con su historial.

Navegar

Acercar / Alejar, Restablecer zoom al 100 % y Ajustar todos los nodos a la vista encuadran el flujo de trabajo en cualquier tamaño.
Herramienta de desplazamiento: cuando está activa, arrastrar desplaza el lienzo en lugar de seleccionar. Arrastrar con el botón central y Espacio+arrastrar desplazan independientemente de la opción.
Ajustar a la cuadrícula redondea las posiciones de los nodos a una cuadrícula fija al soltarlos, para una alineación ordenada.

Minimapa

Para flujos de trabajo grandes que no caben en la pantalla, active el Minimapa para acoplar un panel de vista general en la esquina inferior derecha. Muestra en miniatura los pasos y las conexiones de todo el flujo de trabajo, con un rectángulo que marca la parte del lienzo que está viendo actualmente.

El rectángulo de la ventana gráfica se mueve en directo a medida que desplaza y acerca, de modo que siempre sabe dónde está dentro del diagrama más grande.
Haga clic o arrastre en cualquier punto del panel para saltar a esa parte del flujo de trabajo en el lienzo.
Mientras se ejecuta un flujo de trabajo, cada paso del minimapa se codifica por colores según su estado de ejecución (en ejecución, finalizado, error, etc.), de modo que el panel funciona también como una vista general del estado de un vistazo.

Organizar

Organizar abre un menú de acciones de diseño. Cada acción es un solo paso en Deshacer (Cmd/Ctrl+Z) y se aplica sin confirmación; aparece un aviso que dice Diseño actualizado: presione Deshacer para revertir. Una acción que no cambiaría nada no hace nada. Consulte Organizar el lienzo.
Deshacer y Rehacer retroceden y avanzan por los cambios de diseño (Cmd/Ctrl+Z y Cmd/Ctrl+Mayús+Z), e Historial abre el panel de cambios.

Organizar el lienzo

Acción	Qué hace	Requiere
Ordenar todo	Organiza todos los pasos de izquierda a derecha.	Siempre disponible
Ordenar selección	Organiza solo los elementos seleccionados, manteniendo su esquina superior izquierda donde está. Los demás pasos solo bajan si ahora se superpondrían.	2 o más elementos
Quitar superposiciones	Empuja hacia abajo los elementos superpuestos hasta que ninguno se superponga. Nunca los reordena.	2 o más elementos en el lienzo
Alinear a la izquierda / al centro / a la derecha / arriba / al medio / abajo	Alinea los elementos seleccionados en el borde o el centro que elija.	2 o más elementos
Distribuir horizontalmente / verticalmente	Mantiene el primer y el último elemento donde están y reparte el resto uniformemente entre ellos.	3 o más elementos
Ajustar todo a la cuadrícula	Coloca todos los elementos en la cuadrícula del lienzo y separa los que luego colisionen.	Siempre disponible

Ordenar todo conserva su diseño. Los pasos siguen fluyendo de izquierda a derecha, pero dentro de cada columna mantienen el orden de arriba abajo que ya tenían, y el diseño permanece donde estaba en el lienzo en lugar de saltar al origen.
Los grupos permanecen juntos. Un contenedor se organiza como un solo bloque. Un contenedor contraído se mueve como un único mosaico, y los pasos ocultos en su interior se mueven con él.
Las notas y los resaltados viajan con sus pasos. Todo lo que está sobre un paso se mueve cuando el paso se mueve.
Los grupos cuentan como un solo elemento. Para Alinear, Distribuir y Ordenar selección, un contenedor o un contenedor contraído es un solo elemento, y los pasos de su interior se mueven con él.
Ajustar todo a la cuadrícula es independiente de la opción Ajustar a la cuadrícula de Navegar, que solo afecta al lugar donde queda un paso cuando lo suelta.
Las acciones no disponibles aparecen atenuadas. Los elementos del menú que no se aplican a la selección actual aparecen en gris.
Los flujos de trabajo bloqueados impiden todas las acciones de Organizar. Desbloquee primero el flujo de trabajo.

Anotar

Las anotaciones son solo visuales: documentan el diagrama y nunca afectan a la ejecución.

Agregar nota: coloque una nota adhesiva en cualquier parte del lienzo y luego use Editar texto… para escribir en ella (o Eliminar nota para quitarla).
Agregar resaltado: dibuje un cuadro translúcido alrededor de un grupo de pasos relacionados y póngale una etiqueta con Editar etiqueta… (o Eliminar resaltado para quitarlo).
Color: codifique un paso por colores (o restablézcalo a Predeterminado) para agrupar el trabajo visualmente.

Bloquear

Un flujo de trabajo se puede bloquear para evitar ediciones accidentales. Haga clic en el conmutador de bloqueo para alternar entre Edición del flujo de trabajo: haga clic para bloquear y El flujo de trabajo está bloqueado: haga clic para desbloquearlo y editar. Mientras está bloqueado, el lienzo es de solo lectura hasta que lo desbloquee.

Contraer y cambiar el tamaño de los paneles de la paleta y del Inspector

La paleta de pasos de la izquierda y el Inspector de la derecha se pueden contraer para apartarlos cuando desea toda la ventana para el diagrama.

Contraer un panel: haga clic en el chevrón del encabezado de la paleta o del encabezado del Inspector. El panel se reduce a una barra estrecha con su título en vertical. La barra contraída del Inspector muestra el nombre del paso que tiene seleccionado, de modo que un lienzo a todo el ancho no pierde de vista lo que estaba inspeccionando; pase el puntero sobre ella para ver el nombre completo si está recortado.
Restaurarlo: haga clic en cualquier parte de la barra, no solo en el chevrón.
Teclado: presione [ para contraer o expandir la paleta y ] para contraer o expandir el Inspector. Ambas se ignoran mientras escribe en un campo, por lo que nunca interrumpen el cuadro de filtro ni un cambio de nombre en línea.
Doble clic en un divisor: al hacer doble clic en el divisor junto a un panel, este se contrae o se expande, igual que con el chevrón.
Cambiar el tamaño: arrastre cualquiera de los divisores. Ambos paneles tienen un ancho mínimo; por debajo de este, las tarjetas de Entradas y Salidas del Inspector se desplazan lateralmente en lugar de recortar sus nombres y recuentos de filas.

Exportar el diagrama

El botón de exportación de la barra de herramientas guarda una imagen del lienzo para documentación, revisión o para compartirla. Al hacer clic en él se exporta un PDF; su menú desplegable ofrece Exportar como PDF y Exportar como PNG.

Tema oscuro

El lienzo sigue el tema de PlaidCloud que haya elegido. En el tema Oscuro, el fondo del lienzo, los mosaicos de pasos, los conectores, las notas, los resaltados, los contenedores, el minimapa y, junto a él, la paleta de pasos, el Inspector y el cajón de vista previa de datos se dibujan para un fondo oscuro, con colores de estado de ejecución y texto de etiquetas elegidos para seguir siendo legibles sobre él. Al cambiar de tema se vuelve a cargar la interfaz, y el lienzo adopta los nuevos colores cuando se vuelve a abrir.

Agregar, conectar y editar pasos

Haga clic en un tipo de paso de la paleta para colocarlo en el lienzo, o arrástrelo donde desee. Para conectar pasos, arrastre de un paso a otro para dibujar un conector; esto le indica al motor de ejecución que la salida de un paso alimenta al siguiente.

Un paso que lee una tabla debe ejecutarse después del paso que la escribe. Sincronizar dependencias en la barra de herramientas encuentra los pasos que pueden ejecutarse demasiado pronto y sugiere los conectores que se deben agregar. Consulte Sincronizar dependencias.

Haga clic con el botón derecho en cualquier paso para ver:

Editar configuración del paso…: el formulario de configuración del paso.
Editar detalles del paso…: nombre, nota, control de errores, reintento y condiciones.
Convertir tipo de paso…: cambia el paso a un tipo de operación diferente.
Duplicar paso…: copia este paso. El formulario del paso se abre en su pestaña General, rellenado a partir de este paso, para que pueda cambiar el nombre de la copia y elegir dónde va; la copia conserva la configuración de este paso.
Habilitar paso / Deshabilitar paso: un paso deshabilitado se omite en tiempo de ejecución.
Ver entradas del paso / Ver salidas del paso: abren los datos del paso en el Inspector.
Vista previa de los datos de salida: abre la salida del paso en el cajón de vista previa de datos acoplado. Al pasar el puntero sobre un paso también aparece gradualmente un glifo de exploración que hace lo mismo.
Color: aplica o borra un color del paso.
Eliminar paso…: lo quita de la estructura del flujo de trabajo. Los pasos posteriores que dependían de su salida tendrán que reconfigurarse.

Concurrencia de subflujos de trabajo

Cuando un paso invoca a otro flujo de trabajo (un paso Ejecutar flujo de trabajo, Ejecutar flujo de trabajo condicional o Ejecutar flujo de trabajo en bucle que apunta a un flujo de trabajo que no es una macro), solo puede ejecutarse una invocación de ese subflujo de trabajo a la vez. Un subflujo de trabajo que no es una macro comparte un único estado de ejecución, por lo que dos invocaciones a la vez colisionarían.

Esto importa en el lienzo avanzado porque los pasos que no están ordenados entre sí se ejecutan en paralelo. Si dos de esos pasos invocan al mismo subflujo de trabajo que no es una macro, compiten entre sí.

El diseñador lo comprueba al guardar el lienzo y muestra un aviso titulado Aviso del flujo de trabajo que nombra los pasos infractores y el subflujo de trabajo compartido; por ejemplo:

Los pasos ‘Build’, ‘Refresh’ invocan todos el subflujo de trabajo que no es una macro ‘Load Dims’ pero no están ordenados entre sí; pueden ejecutarse simultáneamente y colisionar (un subflujo de trabajo que no es una macro no puede ejecutarse dos veces a la vez). Ordene los pasos para que no se superpongan, o convierta ‘Load Dims’ en una macro (las macros se ejecutan con aislamiento por invocación).

Para resolverlo:

Ordene los pasos para que no se superpongan: dibuje un conector para que uno se ejecute después del otro.
Convierta el subflujo de trabajo en una macro: cada invocación de una macro se ejecuta en su propio esquema temporal aislado, por lo que es seguro invocar la misma macro de forma concurrente. Consulte Crear una macro y la referencia de Macro Run.

La paleta de pasos

La Paleta de pasos a la izquierda del lienzo contiene todos los tipos de paso que puede agregar, organizados en diez carpetas: Importar; Exportar y archivar; Tablas; Dimensiones; Asignaciones; IA, ML y texto; Espacial; Documentos e informes; Flujo de trabajo y variables; y Sistemas externos. Las carpetas comienzan cerradas. Haga clic en una para abrirla; algunas contienen subcarpetas, como Sage en Importar y Notificaciones en Flujo de trabajo y variables. La paleta recuerda qué carpetas dejó abiertas.

Sombreado de carpetas y guías de sangría

La paleta muestra dónde está en la jerarquía sin que tenga que recordarlo:

Las carpetas se sombrean según su profundidad, de modo que una carpeta de nivel superior, una subcarpeta y los pasos que contienen se distinguen de un vistazo. El sombreado es solo una pista secundaria: el icono de carpeta y el título en negrita ya marcan una carpeta.
Cada carpeta abierta dibuja una guía de sangría vertical a la izquierda de todo lo que contiene, y al hacer clic en una guía se cierra la carpeta a la que pertenece. Es la forma rápida de salir de una carpeta abierta larga cuyo propio encabezado ya se desplazó fuera de la vista. Al pasar el puntero sobre una guía se muestra Contraer esta carpeta.
Las carpetas se abren y se cierran con el mismo cuadro +/− que se usa en las pantallas de dimensiones, de modo que el gesto se lee igual en todo el producto.
El encabezado de la carpeta que está leyendo permanece fijado en la parte superior de la lista mientras se desplaza, de modo que los pasos bajo el puntero nunca son anónimos. Dentro de una subcarpeta, se fijan tanto su encabezado como el de su carpeta principal.
Abrir o cerrar una carpeta conserva su posición de desplazamiento en lugar de devolverlo al principio de la lista.
Expandir todas las carpetas y Contraer todas las carpetas son los dos botones pequeños del encabezado de la paleta, junto al chevrón que contrae la propia paleta.

Hay dos formas de agregar un paso:

Hacer clic en él. La fila parpadea para confirmar que se agregó, y el paso aparece cerca de la parte superior izquierda del lienzo visible, ya seleccionado, de modo que el Inspector muestra sus detalles. Arrástrelo donde desee. ¿Hizo clic en el equivocado? Presione Supr y confirme: sigue seleccionado, así que no hay nada que buscar.
Arrastrarlo desde la paleta hasta el lienzo, y queda donde lo suelte.

Dos cosas más que conviene saber:

Filtro… busca en todo el catálogo por nombre de paso, sin importar qué esté abierto o cerrado. Cada coincidencia se muestra bajo el encabezado de la carpeta de la que procede, de modo que puede ver a qué carpeta pertenece un paso sin abrir nada. Cuando nada coincide, la paleta dice Ningún paso coincide.
La estrella junto a un paso lo fija en Favoritos, una sección que está encima de las carpetas y nunca se archiva dentro de una. Haga clic con el botón derecho en un paso para obtener los mismos Agregar a favoritos / Quitar de favoritos, además de Agregar al lienzo.

Navegación con el teclado y lectores de pantalla

La paleta se puede manejar por completo con el teclado y es navegable con un lector de pantalla: se expone como un árbol, y cada fila indica si es una carpeta, si esa carpeta está abierta y a qué profundidad se encuentra. Cuando se escribe un filtro, los resultados se exponen como la lista plana de coincidencias que son.

Tab pasa del campo Filtro… a la lista (una sola parada para toda la lista, no una por paso) y volver a presionar Tab sale hacia el lienzo. Dentro de la lista:

Tecla	Qué hace
Abajo / Arriba	Pasa a la fila siguiente o anterior
Derecha	Abre la carpeta en la que está o, en un paso, baja
Izquierda	Cierra la carpeta en la que está o, en un paso, sube a la carpeta que lo contiene
Intro o Espacio	Agrega al lienzo el paso en el que está, o abre y cierra la carpeta
Esc	Vuelve al campo Filtro…

Controles de ejecución

El lienzo ejecuta todo el flujo de trabajo o cualquier parte de él. Como la ejecución sigue el grafo, “desde aquí” y “seleccionado” respetan las dependencias en lugar de la posición en la lista.

Acción	Qué ejecuta
Ejecutar flujo de trabajo	Todo el flujo de trabajo desde sus pasos iniciales.
Ejecutar este paso	Solo el paso seleccionado.
Ejecutar desde aquí	El paso seleccionado y todos los pasos posteriores que normalmente se ejecutarían después de él.
Ejecutar selección	Solo los pasos seleccionados: se activan en paralelo y el motor de ejecución los ordena según sus dependencias.
Ejecutar sección	Los pasos seleccionados más todos los pasos que el grafo sitúa entre el primero y el último de su selección en orden topológico.

Mientras se ejecuta un flujo de trabajo puede Pausar (los pasos en curso terminan; los pasos nuevos esperan hasta que usted Reanude), Reanudar un flujo de trabajo pausado o detenido desde donde se quedó, o Detener (los pasos en curso terminan; los pasos en cola se cancelan). Reanudar vuelve a ejecutar el nodo que falló y todo lo que sigue esperándolo, sin tocar los nodos completados; consulte Pausar, detener y reanudar.

Simular

Simular recorre el grafo del flujo de trabajo sin ejecutar las transformaciones reales. Los pasos se pintan como lo harían durante una ejecución real, de modo que puede visualizar el orden y las ramas antes de comprometer el cómputo. No se ejecuta nada y no cambia ningún dato.

Puntos de interrupción

Un punto de interrupción pausa una ejecución cuando llega a un paso, para que pueda inspeccionar la salida anterior antes de que continúe el resto del flujo de trabajo.

Haga clic con el botón derecho en un paso y elija Establecer punto de interrupción (o Borrar punto de interrupción para quitarlo).
Ejecute el flujo de trabajo. Cuando la ejecución llega a un paso con un punto de interrupción, la ejecución se pausa allí; todo lo posterior espera.
Inspeccione las entradas y salidas del paso en el Inspector y, a continuación, use Reanudar para continuar.

Los puntos de interrupción se guardan con el flujo de trabajo, por lo que un punto de interrupción que establezca persiste entre sesiones hasta que lo borre.

Contenedores

Un contenedor agrupa pasos relacionados en un cuadro etiquetado que puede contraer o deshabilitar como una unidad; es útil para organizar flujos de trabajo grandes o para activar y desactivar un subproceso completo.

Agrupar en contenedor: seleccione los pasos, agrúpelos y dé un nombre al contenedor.
Contraer contenedor / Expandir contenedor: pliega el contenedor en un único mosaico para despejar el lienzo, o lo vuelve a abrir.
Deshabilitar contenedor / Habilitar contenedor: al deshabilitar un contenedor se omiten todos sus pasos miembros en una sola acción. Al habilitarlo se restauran.
Cambiar nombre del contenedor…: cambia su etiqueta.
Desagrupar contenedor: quita el contenedor; sus pasos miembros permanecen en el lienzo.
Agregar o quitar pasos: mantenga presionada la tecla Cmd en un Mac o Ctrl en Windows y arrastre un paso a un contenedor. El contenedor se resalta como destino de la operación, y el paso se une a él al soltarlo. Cmd/Ctrl+arrastre un paso fuera de su contenedor hasta un espacio vacío del lienzo para quitarlo. Al soltarlo sobre un contenedor contraído, el paso se agrega a este.

Un paso pertenece como máximo a un contenedor, por lo que soltarlo sobre un contenedor diferente lo mueve. Al arrastrar varios pasos seleccionados, se mueven todos. Si selecciona un contenedor completo y arrastra con Cmd/Ctrl uno de sus pasos, solo se mueve ese paso. Un contenedor simple que se queda sin pasos se elimina. Un arrastre simple solo mueve el paso en el lienzo, Cmd/Ctrl+clic sigue alternando la selección, y soltar fuera del lienzo no cambia nada. Puede deshacer y rehacer los cambios de pertenencia como cualquier otro cambio de diseño; los flujos de trabajo bloqueados no se pueden modificar.

Contenedores de ejecución

Un contenedor simple es una agrupación visual: ordena el lienzo pero no cambia cómo se ejecutan los pasos. Convierta un contenedor en un contenedor de ejecución y también se convierte en una unidad de ejecución: todo el grupo se ejecuta como un subflujo de trabajo sellado, comportándose como un solo nodo en el grafo principal.

Actívelo: haga clic con el botón derecho en el contenedor y active Ejecución. El contenedor se vuelve a dibujar con un borde distinto, una insignia Ejecución en su encabezado y un puerto de entrada y un puerto de salida, de modo que puede distinguir un contenedor de ejecución de un grupo normal de un vistazo. Pase el puntero sobre los puertos para ver sus descripciones emergentes Puerto de entrada y Puerto de salida.

Una arista hacia el puerto de entrada alimenta al grupo sellado; el puerto de salida libera el trabajo posterior solo cuando todos los miembros han terminado.

Cómo se ejecuta: un sub-DAG sellado. Una vez que un contenedor se marca para ejecución, su límite queda sellado en ambas direcciones:

Nada de su interior comienza hasta que han llegado las entradas del contenedor. Cada paso miembro espera a lo que alimenta al grupo, incluso un miembro que no tiene ningún paso anterior propio.
Nada posterior al contenedor comienza hasta que todos los miembros han terminado. La salida del grupo se libera solo cuando termina el último miembro, de modo que el flujo de trabajo principal trata todo el contenedor como un solo nodo.

Las ramas independientes dentro del contenedor siguen ejecutándose en paralelo, exactamente como lo harían en el lienzo abierto: el sellado rige solo el límite del grupo, no el orden del trabajo en su interior.

Conecte un paso anterior al puerto de entrada. Arrastre un conector desde un paso anterior hasta el contenedor y suéltelo en el puerto de entrada. Esa única arista alimenta a todo el grupo: cada miembro que necesita la entrada la recibe una vez que llegan las entradas del contenedor.

Conecte el puerto de salida a un paso posterior. Arrastre un conector desde el Puerto de salida del contenedor, en su borde derecho, hasta el paso posterior que consume la salida del grupo. El paso posterior comienza cuando todos los miembros han terminado, y el conector se dibuja desde el borde del contenedor.

También puede dibujar un conector desde un paso miembro hasta el paso posterior, como cuando conecta dos pasos cualesquiera. El motor de ejecución enruta esa conexión a través del puerto de salida del contenedor por usted, por lo que ambas formas dan el mismo resultado.

Comportamiento ante fallos. Un miembro que falla sigue el mismo control de errores que cualquier otro paso:

Con el valor predeterminado detener en caso de error, el fallo de un miembro detiene la ejecución y todo lo que está más allá del contenedor queda retenido.
Con continuar en caso de error, el miembro que falló se trata como completado; la salida del contenedor se libera igualmente cuando terminan sus ramas restantes, y el trabajo posterior continúa.

Deshabilitar un contenedor de ejecución. Al deshabilitar un contenedor de ejecución se omite como una unidad: sus miembros no se ejecutan y, como un contenedor omitido produce ninguna salida, todo lo posterior al contenedor también se omite en lugar de ejecutarse con una entrada ausente. Esto es distinto de deshabilitar un contenedor simple (que no es de ejecución), que solo omite los pasos miembros; los pasos posteriores que no dependen de esos miembros se siguen ejecutando. Vuelva a habilitar el contenedor para restaurar todo el grupo.

Agregar y quitar pasos. Los pasos de un contenedor de ejecución se cambian de la misma forma, con Cmd/Ctrl+arrastre. PlaidCloud rechaza el movimiento, muestra un mensaje y devuelve el paso a donde estaba cuando:

el paso está conectado al puerto de entrada o de salida del propio contenedor,
el movimiento crearía un ciclo a través del límite del contenedor, o
quitaría el último paso del contenedor. Use Desagrupar contenedor en su lugar.

Ejecutar y supervisar contenedores de ejecución

Un contenedor de ejecución también es algo que se ejecuta y se vigila como una unidad. Puede iniciar solo su trabajo, seguir un estado consolidado mientras se ejecuta y saltar directamente a un fallo dentro de él, tanto en el lienzo como en el Monitor de ejecución.

Ejecutar grupo / Ejecutar grupo y pasos posteriores. Haga clic con el botón derecho en un contenedor de ejecución para ejecutarlo sin tocar el resto del flujo de trabajo:

Ejecutar grupo ejecuta los pasos miembros del contenedor.
Ejecutar grupo y pasos posteriores ejecuta los miembros y todo lo que sigue al contenedor.

Ninguna de las dos vuelve a ejecutar los pasos anteriores que alimentan al contenedor: ejecutan el grupo tal como está, usando la entrada que ya existe. Ambas usan el mismo mecanismo de Ejecutar selección que los pasos individuales, por lo que los miembros se activan en paralelo y el motor de ejecución los ordena según sus dependencias.

Estado en directo del grupo. Mientras se ejecuta un flujo de trabajo, el contenedor muestra un estado consolidado de sus miembros: un punto de estado, un recuento N de M finalizado y un borde de color. El estado refleja a los miembros en conjunto: error si algún miembro falló, en ejecución mientras algún miembro se está ejecutando, finalizado cuando todos los miembros terminaron, omitido cuando se omitió el grupo, etc. Un contenedor contraído muestra el mismo agregado en su único mosaico, de modo que plegar un grupo no oculta cómo va su trabajo.

Saltar al fallo. Cuando un grupo tiene un miembro que falló, haga clic en su estado para seleccionar y centrar ese miembro en el lienzo, sin buscar en el grupo lo que detuvo la ejecución.

Reintentar desde el error. Haga clic con el botón derecho en un contenedor de ejecución que falló y elija Reintentar desde el error para volver a ejecutar solo el miembro (o los miembros) que falló y lo que le sigue dentro del grupo; los miembros que ya tuvieron éxito se omiten. Esta es la diferencia con Ejecutar grupo, que vuelve a ejecutar todos los miembros sin importar nada. Reintentar desde el error es el camino más rápido para volver a verde después de corregir aquello con lo que tropezó un miembro.

Tiempo de la última ejecución. El encabezado del contenedor muestra la suma de las duraciones de la última ejecución de sus miembros, para que pueda leer el costo de todo el grupo de un vistazo en lugar de sumar los miembros usted mismo.

Descripciones emergentes de los puertos. Pase el puntero sobre el Puerto de entrada o el Puerto de salida de un contenedor de ejecución para ver las tablas que cruzan ese límite (las entradas que el grupo recibe o las salidas que entrega a los pasos posteriores) enumeradas en la descripción emergente.

Iterar un contenedor

Un contenedor de ejecución puede ejecutar su sub-DAG sellado una vez por cada iteración de un conjunto de valores, de modo que un grupo que carga y transforma los datos de una región puede procesar cada región por turno sin que usted copie los pasos una vez por región. Haga clic con el botón derecho en un contenedor de ejecución y elija Configuración del contenedor…, luego la pestaña Iterar sobre, y marque Iterar este contenedor de ejecución para activar la iteración (la configuración aparece solo en los contenedores de ejecución, ya que la iteración controla un grupo que se ejecuta como una unidad). La iteración es opcional: deje la casilla sin marcar y el contenedor se ejecuta una vez, de modo que un contenedor puede llevar condiciones por sí solo sin ninguna configuración de iteración.

Cada iteración vincula la variable del bucle al siguiente valor y luego ejecuta todo el grupo sellado, en orden y una iteración a la vez.

Configure el bucle. La pestaña Iterar sobre del cuadro de diálogo Configuración del contenedor… usa el mismo modelo de iteración que el paso Workflow Loop, en subpáginas con pestañas. Elija cómo se construye el conjunto de iteración:

Especificar valores de variables sobre los que iterar: defina usted mismo los valores en la pestaña Iteración manual de valores. Agregue una o más variables de bucle y, para cada una, indique una lista explícita de valores o un rango:

Tipo de rango Itera una vez por…

Entero número a partir de un inicio, un fin y un paso

Letras mayúsculas / Letras minúsculas letra de un rango (A–Z o a–z)

Un rango puede llevar una lista de valores excluidos que se omiten. Cuando define más de una variable, el contenedor se ejecuta una vez por cada combinación de sus valores (el producto cartesiano).
Usar combinación de valores únicos de una tabla: elija una tabla de origen en la pestaña Iterar sobre y, a continuación, en la pestaña Asignación de datos a variables, asigne una o más de sus columnas a nombres de variables de bucle. El contenedor se ejecuta una vez por cada combinación única de los valores de esas columnas. Use la pestaña Filtros de datos de la tabla para restringir las filas que se consideran.

Tipo de rango	Itera una vez por…
Entero	número a partir de un inicio, un fin y un paso
Letras mayúsculas / Letras minúsculas	letra de un rango (`A`–`Z` o `a`–`z`)

Los pasos del contenedor hacen referencia a cada variable de bucle como a cualquier variable del flujo de trabajo, {region}, de modo que el SQL, las expresiones, los nombres de tabla y las rutas de archivo de un miembro pueden variar según la iteración. Opcionalmente, active Combinar la salida de todas las iteraciones para acumular los resultados de cada iteración en lugar de conservar solo el último; consulte la nota siguiente sobre su situación actual.

Cómo se ejecuta. Las iteraciones se ejecutan en serie, una tras otra: los miembros comparten las variables de bucle, por lo que dos iteraciones a la vez leerían los valores de la otra. Cada iteración vincula las variables de bucle al siguiente valor (o combinación) y luego ejecuta todo el grupo como una ejecución normal de contenedor de ejecución; la siguiente iteración comienza solo cuando termina la anterior. Un contenedor está limitado a 1,000 iteraciones.

Qué lee el paso posterior. Como cada iteración sobrescribe las tablas de salida del grupo, un paso posterior al contenedor lee la salida de la última iteración. Si necesita las filas de todas las iteraciones, active Combinar la salida de todas las iteraciones para que las iteraciones se acumulen en lugar de reemplazarse.

Por ejemplo, para crear un extracto filtrado por región, agregue una variable de bucle region con una lista de valores East, West, y asigne a un paso miembro un filtro que lea la variable:

SELECT *
  FROM sales
 WHERE region = '{region}'

El contenedor se ejecuta dos veces (region = 'East' y luego region = 'West'), ejecutando todo el grupo sellado cada vez.

Condiciones del contenedor

Un contenedor de ejecución también puede llevar condiciones que controlan si se ejecuta todo el contenedor: las mismas comprobaciones de variables, tablas, documentos y hora que usan las condiciones de un paso, de modo que ambas funcionan igual. Haga clic con el botón derecho en el contenedor, elija Configuración del contenedor… y abra la pestaña Condiciones, la primera pestaña, donde están las condiciones de un paso: es la misma interfaz de condiciones que usa un paso, sin cambios. Las condiciones no necesitan iteración, por lo que un contenedor puede llevarlas por sí solo con Iterar este contenedor de ejecución desactivado.

Se evalúan una vez, a la entrada. Las condiciones de un contenedor se comprueban una sola vez, cuando se llega al contenedor en el grafo: no una vez por miembro y, en un contenedor iterativo, tampoco una vez por iteración. Si las condiciones se cumplen, cada paso miembro se ejecuta como de costumbre. Si no se cumplen, no se ejecuta ningún miembro; el contenedor no produce ninguna salida, por lo que todo lo posterior también se omite, igual que con un contenedor deshabilitado.

Solo omitir: no hay “ir a”. La condición fallida de un paso puede enviar la ejecución a un paso con nombre en lugar de limitarse a continuar; la de un contenedor no. El selector “ir al paso” que ofrece un paso está oculto para un contenedor, por lo que una condición fallida de contenedor siempre significa omitir el contenedor y todo lo posterior: no hay un punto de llegada alternativo que elegir.

Cómo se combinan:

Deshabilitar prevalece. Un contenedor que ha deshabilitado se omite independientemente de sus condiciones: deshabilitar es una omisión incondicional y más fuerte que ni siquiera las evalúa.
La iteración se controla, no se repite. Un contenedor que itera y además tiene condiciones las comprueba una vez, antes de la primera iteración, para decidir si el bucle se ejecuta. Una condición fallida omite todas las iteraciones, no solo la primera; una condición que se cumple no se vuelve a comprobar de una iteración a otra.
Reanudar conserva la decisión. Al reanudar una ejecución que omitió un contenedor de este modo, no se vuelve a evaluar la condición: el contenedor sigue omitido, como cualquier otra decisión completada antes de la pausa.
Una condición defectuosa hace fallar la ejecución. Un error al evaluar una condición (una comprobación mal configurada, por ejemplo) hace fallar la ejecución con ese error. No se trata igual que una condición fallida, por lo que no omite el contenedor en silencio.

El Inspector

El Inspector de pasos acoplado muestra todo sobre el paso que selecciona:

Entradas y Salidas: los datos que entran y salen del paso. El icono de ojo de una tarjeta de entrada o salida abre el cajón de vista previa de datos para ver rápidamente las primeras filas de esa tabla.
Estadísticas de ejecución: el resultado de Última ejecución del paso, Última duración, el recuento de ejecuciones y resúmenes de tiempos, incluidas las duraciones Promedio y p95, además del Error de la última ejecución o la Advertencia de la última ejecución cuando existe.
Editar configuración del paso… y Editar detalles del paso…: van directamente a los formularios del paso, y permiten cambiar el nombre del paso en línea haciendo clic en su nombre.
Revertir configuración del paso (Flashback): restaura la configuración del paso a una versión guardada anterior.
Ver historial de ejecuciones: abre el historial completo de ejecuciones de este paso.

Seleccione un solo paso para inspeccionarlo; si selecciona varios, el Inspector le remite a las acciones masivas de la barra de herramientas del lienzo.

El Inspector se puede redimensionar (arrastre el divisor entre él y el lienzo) y contraer: el chevrón junto al nombre del paso (o la tecla ]) lo pliega en una barra estrecha que sigue mostrando el nombre del paso seleccionado en vertical, de modo que puede devolver el ancho al lienzo sin perder de vista lo que tenía seleccionado. Haga clic en cualquier parte de la barra para volver a abrirlo. Consulte Contraer y cambiar el tamaño de los paneles de la paleta y del Inspector.

Historial de ejecuciones

Elija Ver el historial de ejecuciones de este flujo de trabajo para ver las ejecuciones anteriores con estadísticas de resumen. El lienzo también pinta un mapa de calor a partir de los registros de ejecución recientes, de modo que los pasos que fallan o son lentos con frecuencia destacan de un vistazo.

Ver registros

Haga clic en Ver registros en la barra de herramientas para saltar directamente a la vista Registro del proyecto, ya filtrada para este flujo de trabajo: el registro de ejecución completo al que de otro modo llegaría desde el área Proyecto. Consulte Ver el registro del flujo de trabajo.

Cuando el lienzo no puede abrir un flujo de trabajo

El lienzo abre un flujo de trabajo incluso cuando una parte de su diseño guardado no se puede leer.

Un contenedor sin posición ni tamaño guardados (por ejemplo, uno creado mediante la API o MCP) se abre, dibujado alrededor de sus pasos miembros.
Otro elemento de diseño que no se puede leer: el flujo de trabajo se abre de todos modos, y una notificación Diseño parcialmente ilegible enumera lo que se restableció u ocultó: hasta tres elementos y luego …y N más. Una anotación oculta se elimina la próxima vez que guarde el diseño.
Un flujo de trabajo que no se puede cargar: un mensaje No se pudo cargar el flujo de trabajo indica el motivo, en lugar de un lienzo en blanco. Cierre el lienzo y abra el flujo de trabajo de nuevo.
Un flujo de trabajo estándar: el lienzo muestra Lienzo visual no disponible: este flujo de trabajo no es avanzado. Use “Convertir a avanzado…” para habilitar el lienzo visual. Elija Convertir a avanzado… en el flujo de trabajo para habilitarlo. Consulte Estándar frente a Avanzado.

Próximos pasos

Sincronizar dependencias: agregue los conectores que hacen que cada paso se ejecute después del paso que escribe una tabla que lee
Optimizar un flujo de trabajo: combine pasos de extracción y reconstruya las dependencias para que el flujo de trabajo se ejecute más rápido
Vista previa de los datos de un paso: explore la salida de cualquier paso en el cajón acoplado de vista previa de datos
Ver el registro del flujo de trabajo: lea el registro de ejecución completo de un flujo de trabajo
Ejecutar un flujo de trabajo: ejecutar un flujo de trabajo de principio a fin
Administrar los errores de los pasos: depuración de fallos
Calendario de próximas ejecuciones: vea cuándo se ejecutarán los flujos de trabajo programados