Este tópico explica o conceito de nó de mesclagem, como criá-lo e configurá-lo, e apresenta um exemplo prático de suas propriedades de agendamento e comportamento em tempo de execução.
Informações básicas
O nó de mesclagem é um tipo de nó de controle lógico no DataStudio. Ele consolida os status de execução de nós upstream para resolver problemas de dependência e acionamento dos nós downstream de um nó de ramificação.
Atualmente, o nó de mesclagem aceita apenas o status de execução Successful. Isso permite que os nós downstream utilizem o nó de mesclagem como uma única dependência confiável.
Por exemplo, suponha que um nó de ramificação C possua duas ramificações mutuamente exclusivas, C1 e C2. Cada uma usa lógica diferente para gravar na mesma tabela do MaxCompute. Se um nó downstream B depender da saída dessa tabela, use um nó de mesclagem J para consolidar as ramificações e defina J como dependência upstream de B. Se B depender diretamente de C1 e C2, uma delas sempre terá o status de instância Branch Not Run, pois sua condição de ramificação não será atendida. Consequentemente, B também assumirá o status Branch Not Run e entrará em estado de simulação (dry-run), ou seja, não executará. O mesmo ocorrerá com todos os nós downstream subsequentes.
Limitações
O recurso de nó de mesclagem está disponível apenas no DataWorks Standard Edition e em edições posteriores. Para adquirir ou atualizar sua edição do DataWorks, consulte Detalhes dos recursos de cada edição do DataWorks.
Criar um nó de mesclagem
-
Acesse a página DataStudio.
Faça login no console do DataWorks. Na região desejada, clique em no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Data Development.
Passe o mouse sobre o ícone
e clique em .Na caixa de diálogo Create Node, insira um Name para o nó e selecione um Path.
Clique em OK.
Definir a lógica de mesclagem
Após criar o nó de mesclagem, a página de configuração abre automaticamente. Use esta página para definir a lógica de mesclagem.
-
Adicione os nós de ramificação upstream a serem mesclados. Esses nós se tornarão pais do nó de mesclagem.
Na área Merged Branch, pesquise o nó pai correspondente pelo nome, ID ou saída do nó e clique no ícone
para adicioná-lo como nó de ramificação.NotaPara mesclar vários nós de ramificação, repita esta etapa para cada nó.
-
Na seção MERGE Condition, configure a condição de mesclagem do nó de ramificação.
Defina a lógica de mesclagem e o status de execução necessário para cada nó de ramificação.
-
As condições da lógica de mesclagem incluem:
AND: O status de execução do nó atual, configurado na área Result, entra em vigor somente se todos os nós de ramificação upstream tiverem concluído a execução e atendido aos respectivos status configurados.
OR: O estado de execução configurado para este nó na área Result entra em vigor apenas quando todos os nós upstream estiverem em estado final (ou seja, tiverem terminado a execução) e qualquer nó de ramificação atender ao seu estado de execução configurado.
-
Os status de execução disponíveis após a conclusão do nó são:
Successful: O nó foi executado com êxito.
Failed: A execução do nó falhou.
-
Branch Not Running: O nó não foi selecionado e encontra-se em estado de simulação (dry-run). Nesse estado, o nó é marcado como bem-sucedido, mas a tarefa não executa de fato.
NotaEste status é válido apenas quando o nó upstream é um nó de ramificação.
-
-
Na seção Result, configure o status de execução do nó atual.
NotaO status de execução do nó atual só pode ser definido como Successful.
Exemplo:
Adicione os nós de ramificação A e B como nós upstream do nó de mesclagem atual.
O status de execução do Nó A está definido como Successful, Branch Not Running ou Failed, o que significa que basta o Nó A concluir sua execução.
O status de execução do Nó B está definido como Successful e Branch Not Running, indicando que a execução do Nó B foi concluída sem falhas.
O operador lógico está definido como AND.
Portanto, o status de execução Successful do nó de mesclagem atual entrará em vigor somente quando o Nó A concluir sua execução E o Nó B também concluir sua execução sem apresentar falhas.
Clique em Scheduling Settings no lado direito da página de configuração do nó para definir as propriedades de agendamento do nó de mesclagem. Para mais informações, consulte Configurar propriedades básicas.
Exemplo de nó de mesclagem
Em um nó downstream, após adicionar um nó de ramificação como nó upstream, defina diferentes caminhos de ramificação selecionando as saídas correspondentes. Por exemplo, no fluxo de negócios ilustrado na figura a seguir, Branch 1 e Branch 2 são dois nós downstream de um nó de ramificação.
A Branch 1 depende da saída autotest.fenzhi121902_1. No painel de configuração Dependencies do nó Branch 1, defina Auto Parse como Yes e adicione manualmente uma dependência upstream. Defina Parent Node Output como autotest_fenzhi121902_1, que corresponde ao nó pai branch_node_121902.
A Branch 2 depende da saída autotest.fenzhi121902_2.
Resultados da execução
Nos Operational Logs, visualize o status de execução dos nós downstream da ramificação que atendem à condição e foram selecionados para execução.
Nos Operational Logs, observe que os nós downstream de uma ramificação que não atendem às condições e não foram selecionados para execução aparecem marcados como ignorados.
O nó downstream do nó de mesclagem executa conforme o esperado.