DataWorks:Nó de mesclagem

O que é um nó de mesclagem?

• O nó de mesclagem é um tipo de nó de controle lógico no Data Studio. Ele consolida os status de execução dos nós upstream para resolver problemas de dependência e acionamento nos nós downstream de um nó de ramificação.

• Atualmente, não é possível definir o status resultante do nó de mesclagem. Quando as condições são atendidas, esse nó sempre reporta status de sucesso. Isso permite que os nós downstream dependam dele sem ambiguidade.

  Por exemplo, considere um nó de ramificação C com duas ramificações mutuamente exclusivas, C1 e C2. Cada uma usa uma lógica diferente para gravar na mesma tabela do MaxCompute. Um nó downstream, B, depende da saída dessa tabela. Para lidar com isso, use um nó de mesclagem J para consolidar as ramificações e faça o nó B depender desse nó de mesclagem. Se o nó B depender diretamente de C1 e C2, ocorrerá um problema. Como as ramificações são mutuamente exclusivas, uma delas sempre terá o status Branch Not Selected. O nó B herdará esse status da ramificação não selecionada e também será ignorado com o status Branch Not Selected. O nó não executará de fato, e esse comportamento se propagará para todos os nós downstream subsequentes.

Pré-requisitos

• O usuário RAM desejado já foi adicionado ao workspace.

  Para desenvolver tarefas com um usuário RAM, adicione-o como membro do workspace e atribua a função Develop ou Workspace Administrator. A função Workspace Administrator concede mais permissões do que o necessário; tenha cautela ao atribuí-la. Para obter mais informações sobre como adicionar membros e atribuir funções, consulte Adicionar membros a um workspace.

• Um grupo de recursos serverless está associado ao workspace. Para mais detalhes, consulte os tópicos no diretório Usar grupos de recursos serverless.

• Um nó de mesclagem já foi criado. Para saber mais, consulte Criar nós para um fluxo de trabalho de agendamento.

Observações de uso

O recurso de nó de mesclagem está disponível apenas no DataWorks Standard Edition ou superior. Para adquirir ou atualizar sua edição do DataWorks, consulte Recursos das edições do DataWorks.

Etapa 1: Desenvolver um nó de mesclagem

Após criar um nó de mesclagem, acesse a página de configuração do nó para definir a lógica de mesclagem.

1. Na seção de definição da lógica de mesclagem, pesquise e adicione os nós que deseja mesclar. Você pode buscar pela saída, pelo ID ou pelo nome do nó.

2. Ao encontrar um nó, clique em para adicioná-lo à seção Merge Condition Settings.

   Nota

   Caso precise mesclar vários nós de ramificação, repita esta etapa para cada nó.

3. Em MERGE Condition, configure as condições de mesclagem para os nós de ramificação.

   • As condições da lógica de mesclagem incluem:

     • AND: Todos os nós de ramificação upstream devem atingir um estado terminal (ou seja, concluir a execução) e atender aos status de execução configurados. Em seguida, o status definido em Result é aplicado ao nó atual.

     • OR: Todos os nós upstream devem atingir um estado terminal (conclusão da execução), e pelo menos um nó de ramificação deve atender ao status de execução configurado. Assim, o status definido em Result é aplicado ao nó atual.

   • Os status de conclusão do nó incluem:

     • Successful: O nó foi executado com sucesso.

     • Failed: A execução do nó falhou.

     • Branch Not Selected: O nó não foi selecionado. Ele é marcado como bem-sucedido, mas não executa de fato (execução simulada).

       Nota

       Esse status se aplica apenas se o nó upstream for um nó de ramificação.

4. Na seção Result, defina o status de execução do nó atual.

   Nota

   No momento, só é possível definir o status do nó como Successful.

   Exemplo:

   • Adicione os nós branch1 e branch2 como nós upstream do nó de mesclagem atual.

   • Defina o status de execução do nó Branch 1 como Successful, Branch Not Running ou Failed. Isso significa que o nó Branch 1 precisa apenas concluir a execução.

   • O status de execução do nó Branch 2 está definido como Successful ou Branch Not Running. Isso indica que o nó Branch 2 concluiu a execução e o nó B não falhou.

   • A condição da lógica de mesclagem está definida como AND.

   O status de execução Successful do nó de mesclagem atual entra em vigor somente quando o nó Branch 1 conclui a execução e o nó Branch 2 também conclui sem falhas.

5. Após desenvolver o nó de mesclagem, clique em Scheduling Settings no lado direito da página de configuração do nó para definir as propriedades de agendamento. Para mais informações, consulte Configurar propriedades de agendamento para um nó.

Etapa 2: Publicar e manter o nó

1. Depois de configurar as propriedades de agendamento, envie e publique o nó de mesclagem no ambiente de produção. Consulte Implantar um nó ou fluxo de trabalho para mais detalhes.

2. Uma tarefa implantada executa periodicamente conforme a configuração de agendamento. Acesse Operation and Maintenance Center > Node O&M > Auto Triggered Task O&M > Auto Triggered Task para visualizar e gerenciar a tarefa periódica implantada. Para saber mais, consulte Introdução ao Operation Center.