Fluxos de trabalho avançados (Designer visual de fluxo de trabalho)

Descrição

Um fluxo de trabalho avançado é executado em uma tela visual — o Designer visual de fluxo de trabalho — em que as etapas são nós de um grafo direcionado (um DAG). As linhas entre os nós mostram como os dados fluem, e o tempo de execução as executa na ordem das dependências, e não de cima para baixo. As ramificações que não dependem umas das outras são executadas em paralelo automaticamente.

Avançado é um dos tipos de fluxo de trabalho do PlaidCloud; o outro é Padrão. Os recursos deste guia — a tela visual, os pontos de interrupção, os contêineres, Executar a partir daqui, Simular e o Inspetor ancorado — são exclusivos do tipo Avançado. A tela também oferece suporte à colaboração em tempo real: várias pessoas podem abrir o mesmo fluxo de trabalho avançado e editá-lo juntas, vendo a presença e as alterações umas das outras ao vivo.

Padrão versus avançado

Todo fluxo de trabalho tem um tipo, escolhido ao criá-lo:

Tipo	As etapas ficam organizadas em…	…e são executadas
Serial padrão	a lista de etapas	de cima para baixo, uma de cada vez
Paralelo padrão	a lista de etapas	a partir da lista, em paralelo quando as dependências permitem
Avançado (tela de DAG)	um grafo visual de nós e conexões	na ordem das dependências — ramificações independentes são executadas em paralelo automaticamente

Os tipos Padrão e Avançado são executados em mecanismos diferentes: um fluxo de trabalho Padrão é executado a partir da sua lista de etapas, enquanto um fluxo de trabalho avançado é executado a partir do grafo que você desenha, seguindo as conexões explícitas de produtor/consumidor entre as etapas. É por isso que o Designer visual de fluxo de trabalho só abre para fluxos de trabalho avançados — setas desenhadas em um fluxo de trabalho Padrão não mudariam a forma como ele é executado.

Escolher o tipo de fluxo de trabalho

Você pode definir o tipo ao criar um fluxo de trabalho ou converter um fluxo de trabalho Padrão existente:

Na criação — o seletor de tipo de fluxo de trabalho oferece Serial padrão, Paralelo padrão, Avançado (tela de DAG) e Macro (em breve). Os novos fluxos de trabalho usam Serial padrão por padrão.
Converter um fluxo de trabalho existente — selecione um fluxo de trabalho Padrão na lista Fluxos de trabalho, escolha Converter em avançado… e confirme. Suas etapas, a configuração delas e suas dependências são preservadas — só muda a forma como o fluxo de trabalho é exibido e executado.

Alterar o tipo de um fluxo de trabalho de Padrão para Avançado pela API REST ou por um assistente de IA mantém a ordem das etapas da mesma forma que Converter em avançado…. Alterar um fluxo de trabalho avançado de volta para Padrão é recusado.

A tela

Cada etapa é um nó, e as conexões entre os nós definem a ordem em que as etapas são executadas. O Designer organiza as etapas automaticamente, e você pode reorganizá-las livremente.

Quem está aqui

Quando mais de uma pessoa tem o mesmo fluxo de trabalho avançado aberto, uma fileira de avatares aparece na barra de ferramentas da tela mostrando quem mais o está visualizando ou editando — a mesma ideia de presença ao vivo de um documento compartilhado. Cada pessoa é mostrada pelo seu gravatar (ou pelas iniciais, se não tiver um), e passar o ponteiro sobre um avatar mostra o nome. Uma pessoa aparece uma única vez, não importa em quantas abas do navegador ela tenha o fluxo de trabalho aberto, e quando há mais pessoas do que cabem, as demais são reunidas em um marcador +N.

Blocos de etapa

Cada bloco resume sua etapa de relance, de cima para baixo:

Cabeçalho — o ícone e o nome do tipo de etapa, mais um ícone de status mostrando o resultado da última execução da etapa.
Entradas — um ícone para cada tabela, dimensão ou arquivo que a etapa lê. Clique no ícone de uma tabela para visualizá-la na gaveta de Pré-visualização de dados, no ícone de uma dimensão para abrir a dimensão, ou no ícone de um arquivo para baixá-lo. Uma etapa com muitas entradas ou saídas reúne as extras em um marcador +N.
Nome da etapa — centralizado no corpo do bloco.
Saídas — ícones das saídas da etapa, com o mesmo comportamento de clique. Quando a tabela de saída existe, esta linha também mostra suas contagens de linhas e colunas (por exemplo, 12,345 rows · 8 cols) — as mesmas linhas e colunas mostradas nas tabelas de entradas/saídas da etapa — para que você acompanhe o movimento dos volumes de dados pelo fluxo de trabalho sem abrir cada tabela. Até lá (ou quando a etapa gera um arquivo ou uma dimensão), a linha mostra apenas o rótulo Saídas. Passe o ponteiro sobre qualquer ícone de tabela para ver o nome e as contagens.
Rodapé — as durações da última execução e a média da etapa, destacadas quando a execução mais recente foi incomumente lenta em comparação com o histórico.

Navegar

Aumentar zoom / Reduzir zoom, Redefinir zoom para 100% e Ajustar todos os nós à visualização enquadram o fluxo de trabalho em qualquer tamanho.
Ferramenta de panorâmica — quando ativa, arrastar move a tela em vez de selecionar. Arrastar com o botão do meio e Espaço+arrastar movem a tela independentemente da alternância.
Ajustar à grade arredonda as posições dos nós para uma grade fixa quando você os solta, para um alinhamento organizado.

Minimapa

Para fluxos de trabalho grandes que não cabem na tela, ative o Minimapa para ancorar um painel de visão geral no canto inferior direito. Ele mostra as etapas e conexões de todo o fluxo de trabalho em miniatura, com um retângulo marcando a parte da tela que você está vendo no momento.

O retângulo da área visível se move ao vivo conforme você faz panorâmica e zoom, para que você sempre saiba onde está no diagrama maior.
Clique ou arraste em qualquer ponto do painel para levar a tela até aquela parte do fluxo de trabalho.
Enquanto um fluxo de trabalho é executado, cada etapa do minimapa é colorida de acordo com seu estado de execução (em execução, concluído, erro etc.), de modo que o painel também serve como uma visão geral de integridade.

Organizar o layout

Organizar abre um menu de ações de layout. Cada ação é uma única etapa em Desfazer (Cmd/Ctrl+Z) e é aplicada sem confirmação; uma notificação informa Layout atualizado — pressione Desfazer para reverter. Uma ação que não mudaria nada não faz nada. Veja Organizar a tela.
Desfazer e Refazer avançam e retrocedem nas alterações de layout (Cmd/Ctrl+Z e Cmd/Ctrl+Shift+Z), e Histórico abre o painel de alterações.

Organizar a tela

Ação	O que faz	Requer
Organizar tudo	Organiza todas as etapas da esquerda para a direita.	Sempre disponível
Organizar seleção	Organiza somente os itens selecionados, mantendo o canto superior esquerdo deles onde está. As demais etapas só descem se passarem a se sobrepor.	2 ou mais itens
Remover sobreposições	Empurra os itens sobrepostos para baixo até que nenhum se sobreponha. Nunca altera a ordem deles.	2 ou mais itens na tela
Alinhar à esquerda / ao centro / à direita / ao topo / ao meio / à base	Alinha os itens selecionados pela borda ou pelo centro que você escolher.	2 ou mais itens
Distribuir horizontalmente / verticalmente	Mantém o primeiro e o último itens onde estão e espaça os demais de forma uniforme entre eles.	3 ou mais itens
Ajustar tudo à grade	Coloca todos os itens da tela na grade e separa os que passarem a colidir.	Sempre disponível

Organizar tudo preserva o seu layout. As etapas continuam fluindo da esquerda para a direita, mas, dentro de cada coluna, mantêm a ordem de cima para baixo que você já tinha, e o layout permanece onde estava na tela, sem saltar para a origem.
Os grupos permanecem juntos. Um contêiner é organizado como um único bloco. Um contêiner recolhido se move como um único bloco, e as etapas ocultas dentro dele vão junto.
Notas e destaques acompanham suas etapas. Tudo o que estiver sobre uma etapa se move quando a etapa se move.
Os grupos contam como um item. Para Alinhar, Distribuir e Organizar seleção, um contêiner ou contêiner recolhido é um item, e as etapas dentro dele se movem com ele.
Ajustar tudo à grade é separado da alternância Ajustar à grade em Navegar, que afeta apenas o ponto em que uma etapa para quando você a solta.
As ações indisponíveis ficam esmaecidas. Os itens de menu que não se aplicam à seleção atual ficam acinzentados.
Fluxos de trabalho bloqueados impedem todas as ações de Organizar. Desbloqueie o fluxo de trabalho primeiro.

Anotar

As anotações são apenas visuais — documentam o diagrama e nunca afetam a execução.

Adicionar nota — coloque uma nota adesiva em qualquer ponto da tela e use Editar texto… para escrever nela (ou Excluir nota para removê-la).
Adicionar destaque — desenhe uma caixa translúcida em volta de um grupo de etapas relacionadas e dê a ela um rótulo com Editar rótulo… (ou Excluir destaque para removê-la).
Cor — use cores para marcar uma etapa (ou redefina-a para Padrão) e agrupar o trabalho visualmente.

Bloquear

Um fluxo de trabalho pode ser bloqueado para evitar edições acidentais. Clique na alternância de bloqueio para alternar entre Edição do fluxo de trabalho — clique para bloquear e O fluxo de trabalho está bloqueado — clique para desbloquear a edição. Enquanto estiver bloqueada, a tela é somente leitura até você desbloqueá-la.

Recolher e redimensionar os painéis da paleta e do Inspetor

A paleta de etapas à esquerda e o Inspetor à direita podem ser recolhidos para o lado quando você quiser toda a janela para o diagrama.

Recolher um painel — clique na seta no título da paleta ou no cabeçalho do Inspetor. O painel se reduz a uma barra estreita com o título na vertical. A barra recolhida do Inspetor mostra o nome da etapa selecionada, para que uma tela em largura total não perca de vista o que você estava inspecionando; passe o ponteiro sobre ela para ver o nome completo, se estiver cortado.
Trazê-lo de volta — clique em qualquer ponto da barra, não apenas na seta.
Teclado — pressione [ para recolher ou expandir a paleta e ] para recolher ou expandir o Inspetor. Ambos são ignorados enquanto você digita em um campo, de modo que nunca interrompem a caixa de filtro nem uma renomeação em linha.
Clique duplo em um divisor — clicar duas vezes no divisor ao lado de um painel o recolhe ou expande, da mesma forma que a seta.
Redimensionar — arraste qualquer um dos divisores. Os dois painéis têm uma largura mínima; abaixo dela, os cartões de Entradas e Saídas do Inspetor rolam lateralmente em vez de cortar seus nomes e contagens de linhas.

Exportar o diagrama

O botão de exportação da barra de ferramentas salva uma imagem da tela para documentação, revisão ou compartilhamento. Clicar nele exporta um PDF; o menu suspenso oferece Exportar como PDF e Exportar como PNG.

Tema escuro

A tela segue o tema do PlaidCloud que você escolheu. No tema Escuro, o fundo da tela, os blocos de etapa, os conectores, as notas, os destaques, os contêineres, o minimapa e também a paleta de etapas, o Inspetor e a gaveta de Pré-visualização de dados ao lado são desenhados para um fundo escuro, com cores de status de execução e texto de rótulos escolhidos para continuarem legíveis. Trocar de tema recarrega a interface, e a tela adota as novas cores quando é reaberta.

Adicionar, conectar e editar etapas

Clique em um tipo de etapa na paleta para soltá-lo na tela, ou arraste-o para onde quiser. Para conectar etapas, arraste de uma etapa para outra para desenhar um conector — é isso que informa ao tempo de execução que a saída de uma etapa alimenta a seguinte.

Uma etapa que lê uma tabela deve ser executada depois da etapa que a grava. Sincronizar dependências na barra de ferramentas encontra etapas que podem ser executadas cedo demais e sugere os conectores a adicionar. Veja Sincronizar dependências.

Clique com o botão direito em qualquer etapa para acessar:

Editar configuração da etapa… — o formulário de configurações da etapa.
Editar detalhes da etapa… — nome, memorando, tratamento de erros, nova tentativa e condições.
Converter tipo da etapa… — muda a etapa para outro tipo de operação.
Duplicar etapa… — copia esta etapa. O formulário da etapa abre na guia Geral, preenchido a partir desta etapa, para que você renomeie a cópia e escolha onde ela fica; a cópia mantém a configuração desta etapa.
Ativar etapa / Desativar etapa — uma etapa desativada é ignorada na execução.
Ver entradas da etapa / Ver saídas da etapa — abrem os dados da etapa no Inspetor.
Pré-visualizar dados de saída — abre a saída da etapa na gaveta de Pré-visualização de dados ancorada. Passar o ponteiro sobre uma etapa também faz surgir um ícone de navegação que faz o mesmo.
Cor — aplica ou limpa a cor de uma etapa.
Excluir etapa… — remove a etapa da estrutura do fluxo de trabalho. As etapas seguintes que dependiam da saída dela precisarão ser reconfiguradas.

Concorrência de subfluxos de trabalho

Quando uma etapa invoca outro fluxo de trabalho — uma etapa Executar fluxo de trabalho, Executar fluxo de trabalho condicional ou Executar fluxo de trabalho em loop apontando para um fluxo de trabalho que não é um Macro — somente uma invocação desse subfluxo de trabalho pode ser executada por vez. Um subfluxo de trabalho que não é Macro compartilha um único estado de execução, então duas invocações simultâneas colidiriam.

Isso importa na tela avançada porque etapas sem ordem definida entre si são executadas em paralelo. Se duas dessas etapas invocarem o mesmo subfluxo de trabalho que não é Macro, elas entram em disputa.

O designer verifica isso quando você salva a tela e mostra uma notificação de aviso intitulada Aviso do fluxo de trabalho que nomeia as etapas envolvidas e o subfluxo de trabalho compartilhado — por exemplo:

As etapas ‘Build’, ‘Refresh’ invocam todas o subfluxo de trabalho que não é macro ‘Load Dims’, mas não têm ordem definida entre si; podem ser executadas simultaneamente e colidir (um subfluxo de trabalho que não é macro não pode ser executado duas vezes ao mesmo tempo). Ordene as etapas para que não se sobreponham ou transforme ‘Load Dims’ em uma macro (as macros são executadas com isolamento por invocação).

Para resolver:

Ordene as etapas para que não se sobreponham — desenhe um conector para que uma seja executada depois da outra.
Transforme o subfluxo de trabalho em um Macro — cada invocação de um Macro é executada em seu próprio esquema temporário isolado, então o mesmo Macro pode ser chamado simultaneamente com segurança. Veja Criar uma macro e a referência da etapa Macro Run.

A paleta de etapas

A Paleta de etapas, à esquerda da tela, contém todos os tipos de etapa que você pode adicionar, organizados em dez pastas: Importar; Exportação e arquivamento; Tabelas; Dimensões; Alocações; IA, ML e texto; Espacial; Documentos e relatórios; Fluxo de trabalho e variáveis; e Sistemas externos. As pastas começam fechadas. Clique em uma para abri-la; algumas contêm subpastas, como Sage em Importar e Notificações em Fluxo de trabalho e variáveis. A paleta lembra quais pastas você deixou abertas.

Sombreamento de pastas e guias de recuo

A paleta mostra onde você está na hierarquia sem que você precise lembrar:

As pastas são sombreadas por profundidade, de modo que uma pasta de nível superior, uma subpasta e as etapas dentro delas se distinguem de relance. O sombreamento é apenas uma pista secundária — o ícone de pasta e o título em negrito já marcam uma pasta.
Cada pasta aberta desenha uma guia de recuo vertical à esquerda de tudo o que está dentro dela, e clicar em uma guia fecha a pasta a que ela pertence. É a saída rápida de uma pasta aberta e longa cujo título já rolou para fora da tela. Passar o ponteiro sobre uma guia mostra Recolher esta pasta.
As pastas abrem e fecham com a mesma caixa +/− usada nas telas de dimensões, para que o gesto seja lido da mesma forma em todo o produto.
O título da pasta que você está lendo permanece fixo no topo da lista enquanto você rola, para que as etapas sob o seu ponteiro nunca fiquem anônimas. Dentro de uma subpasta, o título dela e o da pasta superior ficam ambos fixos.
Abrir ou fechar uma pasta mantém a posição de rolagem, em vez de levar você de volta ao topo da lista.
Expandir todas as pastas e Recolher todas as pastas são os dois pequenos botões no título da paleta, ao lado da seta que recolhe a própria paleta.

Há duas maneiras de adicionar uma etapa:

Clique nela. A linha pisca para confirmar a adição, e a etapa aparece perto do canto superior esquerdo da tela visível, já selecionada, de modo que o Inspetor mostra seus detalhes. Arraste-a para onde quiser. Clicou na errada? Pressione Delete e confirme — ela ainda está selecionada, então não há nada para procurar.
Arraste-a da paleta para a tela, e ela fica onde você soltar.

Mais duas coisas que vale saber:

Filtrar… pesquisa todo o catálogo pelo nome da etapa, estejam as pastas abertas ou fechadas. Cada resultado é listado sob o título da pasta de onde veio, para que você veja a que pasta uma etapa pertence sem abrir nada. Quando nada corresponde, a paleta mostra Nenhuma etapa correspondente.
A estrela ao lado de uma etapa a fixa em Favoritos, uma seção que fica acima das pastas e nunca é arquivada dentro de uma. Clique com o botão direito em uma etapa para ver as mesmas opções Adicionar aos favoritos / Remover dos favoritos, além de Adicionar à tela.

Navegação pelo teclado e leitores de tela

A paleta pode ser operada inteiramente pelo teclado e é navegável com um leitor de tela: ela é exposta como uma árvore, e cada linha informa se é uma pasta, se a pasta está aberta e em que profundidade está. Com um filtro digitado, os resultados são expostos como a lista simples de correspondências que são.

Tab leva do campo Filtrar… para a lista — uma parada para a lista toda, não uma por etapa — e Tab de novo sai para a tela. Dentro da lista:

Tecla	O que faz
Seta para baixo / para cima	Vai para a linha seguinte ou anterior
Seta para a direita	Abre a pasta em que você está — ou, em uma etapa, desce
Seta para a esquerda	Fecha a pasta em que você está — ou, em uma etapa, sobe para a pasta que a contém
Enter ou Espaço	Adiciona a etapa em que você está à tela, ou abre e fecha a pasta
Esc	Volta ao campo Filtrar…

Controles de execução

A tela executa o fluxo de trabalho inteiro ou qualquer parte dele. Como a execução segue o grafo, “a partir daqui” e “selecionadas” respeitam as dependências, e não a posição na lista.

Ação	O que executa
Executar fluxo de trabalho	O fluxo de trabalho inteiro, a partir das etapas iniciais.
Executar esta etapa	Somente a etapa selecionada.
Executar a partir daqui	A etapa selecionada e todas as etapas seguintes que normalmente seriam executadas depois dela.
Executar selecionadas	Somente as etapas selecionadas — elas disparam em paralelo e o tempo de execução as ordena pelas dependências.
Executar seção	As etapas selecionadas mais todas as etapas que o grafo coloca entre a mais antiga e a mais recente da sua seleção, em ordem topológica.

Enquanto um fluxo de trabalho está em execução, você pode Pausar (as etapas em andamento terminam; as novas aguardam até você Retomar), Retomar um fluxo de trabalho pausado ou interrompido do ponto em que parou, ou Parar (as etapas em andamento terminam; as que estão na fila são canceladas). Retomar executa novamente o nó que falhou e tudo o que ainda aguarda por ele, deixando os nós concluídos em paz — veja Pausar, parar e retomar.

Simular

Simular percorre o grafo do fluxo de trabalho sem executar as transformações de fato. As etapas são pintadas como seriam durante uma execução real, para que você visualize a ordem e as ramificações antes de se comprometer com o processamento. Nada é executado e nenhum dado é alterado.

Pontos de interrupção

Um ponto de interrupção pausa uma execução quando ela chega a uma etapa, para que você inspecione a saída anterior antes que o restante do fluxo de trabalho continue.

Clique com o botão direito em uma etapa e escolha Definir ponto de interrupção (ou Limpar ponto de interrupção para removê-lo).
Execute o fluxo de trabalho. Quando a execução chega a uma etapa com ponto de interrupção, ela pausa ali; tudo o que vem depois aguarda.
Inspecione as entradas e saídas da etapa no Inspetor e depois use Retomar para continuar.

Os pontos de interrupção são salvos com o fluxo de trabalho, então um ponto de interrupção que você definir persiste entre as sessões até que você o limpe.

Contêineres

Um contêiner agrupa etapas relacionadas em uma caixa rotulada que você pode recolher ou desativar como uma unidade — útil para organizar fluxos de trabalho grandes ou para ativar e desativar um subprocesso inteiro.

Agrupar em contêiner — selecione as etapas, agrupe-as e dê um nome ao contêiner.
Recolher contêiner / Expandir contêiner — reduz o contêiner a um único bloco para desafogar a tela, ou o abre novamente.
Desativar contêiner / Ativar contêiner — desativar um contêiner ignora todas as etapas membros de uma só vez. Ativar as restaura.
Renomear contêiner… — altera o rótulo dele.
Desagrupar contêiner — remove o contêiner; as etapas membros permanecem na tela.
Adicionar ou remover etapas — mantenha Cmd no Mac ou Ctrl no Windows e arraste uma etapa para um contêiner. O contêiner é destacado como destino do arrasto, e a etapa entra nele quando você solta. Cmd/Ctrl+arrastar uma etapa para fora do contêiner, para uma área vazia da tela, a remove. Soltar sobre um contêiner recolhido adiciona a etapa a ele.

Uma etapa pertence a no máximo um contêiner, então soltá-la sobre outro contêiner a move. Arrastar várias etapas selecionadas move todas elas. Se você selecionar um contêiner inteiro e fizer Cmd/Ctrl+arrastar em uma de suas etapas, somente essa etapa se move. Um contêiner simples que fique sem etapas é removido. Um arrasto simples apenas move a etapa na tela, Cmd/Ctrl+clique continua alternando a seleção e soltar fora da tela não muda nada. Você pode desfazer e refazer alterações de associação como qualquer outra alteração de layout; fluxos de trabalho bloqueados não podem ser alterados.

Contêineres de execução

Um contêiner simples é um agrupamento visual — organiza a tela, mas não muda a forma como as etapas são executadas. Transforme um contêiner em um contêiner de execução e ele também passa a ser uma unidade de execução: o grupo inteiro é executado como um subfluxo de trabalho selado, comportando-se como um único nó no grafo superior.

Ative-o — clique com o botão direito no contêiner e ative Execução. O contêiner é redesenhado com uma borda distinta, um selo Execução no cabeçalho e uma porta de entrada e uma porta de saída, para que você distinga um contêiner de execução de um grupo comum de relance. Passe o ponteiro sobre as portas para ver as dicas Porta de entrada e Porta de saída.

Uma única conexão na porta de entrada alimenta o grupo selado; a porta de saída só libera o trabalho seguinte depois que todos os membros terminarem.

Como é executado — um sub-DAG selado. Depois que um contêiner é marcado para execução, sua fronteira fica selada nos dois sentidos:

Nada dentro dele começa até que as entradas do contêiner tenham chegado. Toda etapa membro aguarda o que alimenta o grupo, mesmo uma que não tenha nenhuma etapa anterior própria.
Nada depois do contêiner começa até que todos os membros tenham terminado. A saída do grupo só é liberada quando o último membro termina, de modo que o fluxo de trabalho superior trata o contêiner inteiro como um único nó.

As ramificações independentes dentro do contêiner continuam sendo executadas em paralelo, exatamente como na tela aberta — o selo governa apenas a fronteira do grupo, não a ordem do trabalho dentro dele.

Conecte uma etapa anterior à porta de entrada. Arraste um conector de uma etapa anterior até o contêiner e solte-o na porta de entrada. Essa única conexão alimenta o grupo inteiro — cada membro que precisa da entrada a recebe assim que as entradas do contêiner chegam.

Conecte a porta de saída a uma etapa seguinte. Arraste um conector da Porta de saída do contêiner, na borda direita, até a etapa seguinte que consome a saída do grupo. A etapa seguinte começa quando todos os membros terminam, e o conector é desenhado a partir da borda do contêiner.

Você também pode desenhar um conector de uma etapa membro até a etapa seguinte, como faria para conectar duas etapas quaisquer. O tempo de execução roteia essa conexão pela porta de saída do contêiner para você, então as duas formas dão o mesmo resultado.

Comportamento em caso de falha. Um membro que falha segue o mesmo tratamento de erros de qualquer outra etapa:

Com o padrão parar em caso de erro, a falha de um membro interrompe a execução, e tudo o que vem depois do contêiner fica retido.
Com continuar em caso de erro, o membro que falhou é tratado como concluído; a saída do contêiner ainda é liberada quando suas demais ramificações terminam, e o trabalho seguinte prossegue.

Desativar um contêiner de execução. Desativar um contêiner de execução o ignora como uma unidade — seus membros não são executados e, como um contêiner ignorado não produz nenhuma saída, tudo o que vem depois dele também é ignorado, em vez de ser executado sobre uma entrada ausente. Isso é diferente de desativar um contêiner simples (que não é de execução), que ignora apenas as etapas membros; as etapas seguintes que não dependem desses membros continuam sendo executadas. Reative o contêiner para restaurar o grupo inteiro.

Adicionar e remover etapas. Você altera as etapas de um contêiner de execução da mesma forma, com Cmd/Ctrl+arrastar. O PlaidCloud recusa a movimentação, mostra uma mensagem e devolve a etapa ao lugar onde estava, quando:

a etapa está conectada à porta de entrada ou de saída do próprio contêiner,
a movimentação criaria um ciclo através da fronteira do contêiner, ou
ela removeria a última etapa do contêiner. Use Desagrupar contêiner nesse caso.

Executar e monitorar contêineres de execução

Um contêiner de execução também é algo que você executa e acompanha como uma unidade. Você pode iniciar apenas o trabalho dele, acompanhar um status consolidado durante a execução e ir direto a uma falha dentro dele — tanto na tela quanto no Monitor de execução.

Executar grupo / Executar grupo + etapas seguintes. Clique com o botão direito em um contêiner de execução para executá-lo sem tocar no restante do fluxo de trabalho:

Executar grupo executa as etapas membros do contêiner.
Executar grupo + etapas seguintes executa os membros e tudo o que vem depois do contêiner.

Nenhuma das duas executa novamente as etapas anteriores que alimentam o contêiner — elas executam o grupo no estado em que está, usando a entrada já existente. Ambas usam o mesmo mecanismo de Executar selecionadas das etapas individuais, então os membros disparam em paralelo e o tempo de execução os ordena pelas dependências.

Status ao vivo do grupo. Enquanto um fluxo de trabalho é executado, o contêiner mostra um status consolidado de seus membros: um indicador de status, uma contagem N de M concluídas e uma borda colorida. O status reflete os membros como um todo — erro se algum membro falhou, em execução enquanto algum membro estiver em execução, concluído quando todos os membros terminaram, ignorado quando o grupo foi ignorado, e assim por diante. Um contêiner recolhido mostra o mesmo agregado como seu bloco único, então recolher um grupo não esconde como o trabalho dele está indo.

Ir direto à falha. Quando um grupo tem um membro com falha, clique no status dele para selecionar e centralizar esse membro na tela — sem precisar procurar dentro do grupo o que interrompeu a execução.

Tentar novamente a partir da falha. Clique com o botão direito em um contêiner de execução com falha e escolha Tentar novamente a partir da falha para executar de novo somente o membro (ou membros) que falhou e o que vem depois dele dentro do grupo; os membros que já tiveram êxito são ignorados. Essa é a diferença em relação a Executar grupo, que executa novamente todos os membros, independentemente do resultado. Tentar novamente a partir da falha é o caminho mais rápido de volta ao verde depois que você corrigiu o que fez um membro falhar.

Hora da última execução. O cabeçalho do contêiner mostra a soma das durações da última execução dos membros, para que você leia o custo do grupo inteiro de relance, em vez de somar os membros por conta própria.

Dicas das portas. Passe o ponteiro sobre a Porta de entrada ou a Porta de saída de um contêiner de execução para ver as tabelas que cruzam essa fronteira — as entradas que o grupo recebe ou as saídas que ele entrega às etapas seguintes — listadas na dica.

Iterar um contêiner

Um contêiner de execução pode executar seu sub-DAG selado uma vez por iteração de um conjunto de valores — assim, um grupo que carrega e transforma os dados de uma região pode processar todas as regiões em sequência, sem que você copie as etapas uma vez por região. Clique com o botão direito em um contêiner de execução, escolha Configurações do contêiner…, depois a guia Iterar sobre, e marque Iterar este contêiner de execução para ativar a iteração (as configurações aparecem apenas em contêineres de execução, já que a iteração conduz um grupo que é executado como uma unidade). A iteração é opcional — deixe a caixa desmarcada e o contêiner será executado uma vez, de modo que um contêiner pode ter condições por si só, sem nenhuma configuração de iteração.

Cada passo vincula a variável do loop ao valor seguinte e depois executa todo o grupo selado — em ordem, um passo por vez.

Configure o loop. A guia Iterar sobre da caixa de diálogo Configurações do contêiner… usa o mesmo modelo de iteração da etapa Workflow Loop, em subpáginas com guias. Escolha como o conjunto de iteração é construído:

Especificar valores de variáveis para iterar — defina você mesmo os valores na guia Iteração manual de valores. Adicione uma ou mais variáveis de loop e, para cada uma, informe uma lista explícita de valores ou um intervalo:

Tipo de intervalo Itera uma vez para cada…

Inteiro número a partir de um início, fim e passo

Alfa maiúsculo / Alfa minúsculo letra em um intervalo (A–Z ou a–z)

Um intervalo pode ter uma lista de valores excluídos a ignorar. Quando você define mais de uma variável, o contêiner é executado uma vez por combinação dos valores delas (o produto cartesiano).
Usar combinação de valores exclusivos da tabela — escolha uma tabela de origem na guia Iterar sobre e, na guia Mapeamento de dados para variáveis, mapeie uma ou mais de suas colunas para nomes de variáveis de loop. O contêiner é executado uma vez por combinação exclusiva dos valores dessas colunas. Use a guia Filtros de dados da tabela para restringir quais linhas são consideradas.

Tipo de intervalo	Itera uma vez para cada…
Inteiro	número a partir de um início, fim e passo
Alfa maiúsculo / Alfa minúsculo	letra em um intervalo (`A`–`Z` ou `a`–`z`)

As etapas dentro do contêiner referenciam cada variável de loop como qualquer variável do fluxo de trabalho — {region} — de modo que o SQL, as expressões, os nomes de tabelas e os caminhos de arquivos de um membro podem variar a cada iteração. Opcionalmente, ative Combinar a saída de todas as iterações para acumular os resultados de cada passo em vez de manter apenas o último — veja a observação abaixo sobre a situação desse recurso.

Como é executado. As iterações são executadas em série, uma após a outra — os membros compartilham as variáveis de loop, então dois passos ao mesmo tempo leriam os valores um do outro. Cada iteração vincula as variáveis de loop ao valor seguinte (ou combinação) e depois executa o grupo inteiro como uma execução comum de contêiner de execução; a iteração seguinte só começa quando a anterior termina. Um contêiner é limitado a 1.000 iterações.

O que as etapas seguintes leem. Como cada passo sobrescreve as tabelas de saída do grupo, uma etapa depois do contêiner lê a saída da última iteração. Se você precisa das linhas de todas as iterações, ative Combinar a saída de todas as iterações para que os passos se acumulem em vez de substituir.

Por exemplo, para montar uma extração filtrada por região, adicione uma variável de loop region com uma lista de valores East, West e dê a uma etapa membro um filtro que leia a variável:

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

O contêiner é executado duas vezes — region = 'East', depois region = 'West' — executando o grupo selado inteiro a cada vez.

Condições do contêiner

Um contêiner de execução também pode ter condições que determinam se o contêiner inteiro é executado — as mesmas verificações de variável, tabela, documento e hora que as condições de uma etapa usam, de modo que as duas funcionam da mesma forma. Clique com o botão direito no contêiner, escolha Configurações do contêiner… e abra a guia Condições — a primeira guia, onde ficam as condições de uma etapa: é a mesma interface de Condições que uma etapa usa, sem alterações. As condições não exigem iteração, então um contêiner pode ter condições por si só, com Iterar este contêiner de execução desmarcado.

Avaliadas uma vez, na entrada. As condições de um contêiner são verificadas uma única vez, quando o contêiner é alcançado no grafo — não uma vez por membro e, em um contêiner com iteração, também não uma vez por iteração. Se as condições forem atendidas, todas as etapas membros são executadas normalmente. Se não forem, nenhum membro é executado; o contêiner não produz nenhuma saída, então tudo o que vem depois dele também é ignorado, como em um contêiner desativado.

Somente ignorar — não existe “ir para”. A condição não atendida de uma etapa pode enviar a execução a uma etapa nomeada, em vez de simplesmente seguir adiante; a de um contêiner não pode. O seletor “ir para a etapa” que uma etapa oferece fica oculto para um contêiner, então uma condição não atendida do contêiner sempre significa ignorar o contêiner e tudo o que vem depois dele — não há um ponto de chegada alternativo para escolher.

Como se combinam:

Desativar prevalece. Um contêiner que você desativou é ignorado independentemente de suas condições — desativar é um salto mais forte e incondicional, que nem avalia as condições.
A iteração é condicionada, não repetida. Um contêiner que tem iteração e condições verifica as condições uma vez, antes da primeira iteração, para decidir se o loop será executado. Uma condição não atendida ignora todas as iterações, não só a primeira; uma condição atendida não é verificada de novo a cada passo.
Retomar mantém a decisão. Retomar uma execução que ignorou um contêiner dessa forma não reavalia a condição — o contêiner permanece ignorado, como qualquer outra decisão concluída antes da pausa.
Uma condição com defeito faz a execução falhar. Um erro ao avaliar uma condição — uma verificação mal configurada, por exemplo — faz a execução falhar com esse erro. Ele não é tratado da mesma forma que uma condição não atendida, então não ignora o contêiner silenciosamente.

O Inspetor

O Inspetor de etapas ancorado mostra tudo sobre a etapa selecionada:

Entradas e Saídas — os dados que entram e saem da etapa. O ícone de olho em um cartão de entrada ou saída abre a gaveta de Pré-visualização de dados para uma olhada rápida nas primeiras linhas dessa tabela.
Estatísticas de execução — o resultado da Última execução da etapa, a Última duração, a contagem de execuções e resumos de tempo, incluindo as durações Média e p95, além do Erro da última execução ou do Aviso da última execução, quando houver.
Editar configuração da etapa… e Editar detalhes da etapa… — vão direto aos formulários da etapa; renomeie a etapa em linha clicando no nome dela.
Reverter configuração da etapa (Flashback) — restaura a configuração da etapa para uma versão salva anteriormente.
Ver histórico de execuções — abre o histórico completo de execuções desta etapa.

Selecione uma única etapa para inspecioná-la; selecione várias e o Inspetor orienta você para as ações em massa da barra de ferramentas da tela.

O Inspetor é redimensionável — arraste o divisor entre ele e a tela — e recolhível: a seta ao lado do nome da etapa (ou a tecla ]) o reduz a uma barra estreita que continua mostrando o nome da etapa selecionada na vertical, para que você devolva a largura à tela sem perder de vista o que tinha selecionado. Clique em qualquer ponto da barra para abri-lo novamente. Veja Recolher e redimensionar os painéis da paleta e do Inspetor.

Histórico de execuções

Escolha Ver o histórico de execuções deste fluxo de trabalho para ver as execuções anteriores com estatísticas resumidas. A tela também pinta um mapa de calor a partir dos registros de execuções recentes, para que as etapas que falham ou ficam lentas com frequência se destaquem de relance.

Ver logs

Clique em Ver logs na barra de ferramentas para ir direto à visão Log do projeto, já filtrada por este fluxo de trabalho — o log completo de execuções que você alcançaria de outra forma pela área do projeto. Veja Exibir o log do fluxo de trabalho.

Quando a tela não consegue abrir um fluxo de trabalho

A tela abre um fluxo de trabalho mesmo quando parte do layout salvo não pode ser lida.

Um contêiner sem posição ou tamanho salvos — por exemplo, um criado pela API ou pelo MCP — abre, desenhado em volta de suas etapas membros.
Outro item de layout que não pode ser lido — o fluxo de trabalho ainda abre, e uma notificação Layout parcialmente ilegível lista o que foi redefinido ou ocultado: até três itens, depois …e mais N. Uma anotação oculta é removida na próxima vez que você salvar o layout.
Um fluxo de trabalho que não pode ser carregado — uma mensagem Não foi possível carregar o fluxo de trabalho informa o motivo, em vez de uma tela em branco. Feche a tela e abra o fluxo de trabalho novamente.
Um fluxo de trabalho Padrão — a tela mostra Tela visual indisponível — Este fluxo de trabalho não é avançado. Use ‘Converter em avançado…’ para ativar a tela visual. Escolha Converter em avançado… no fluxo de trabalho para ativá-la. Veja Padrão versus avançado.

Próximas etapas

Sincronizar dependências — adicione os conectores que fazem cada etapa ser executada depois da etapa que grava uma tabela que ela lê
Otimizar um fluxo de trabalho — una etapas de extração e reconstrua dependências para que o fluxo de trabalho seja executado mais rápido
Pré-visualizar dados da etapa — navegue pela saída de qualquer etapa na gaveta de Pré-visualização de dados ancorada
Exibir o log do fluxo de trabalho — leia o log de execução completo de um fluxo de trabalho
Executar um fluxo de trabalho — executar um fluxo de trabalho de ponta a ponta
Gerenciar erros de etapas — depuração de falhas
Calendário de próximas execuções — veja quando os fluxos de trabalho agendados serão executados