DataWorks:Nó de mesclagem

O que é um nó de mesclagem?

• No Data Studio, o nó de mesclagem atua como um nó de controle lógico que consolida os status de execução dos nós upstream. Isso resolve questões de dependência e acionamento para os nós downstream de um nó de ramificação.

• Não é possível personalizar o status resultante de um nó de mesclagem. Quando as condições são atendidas, esse nó sempre reporta um status de sucesso. Assim, os nós downstream podem depender dele sem ambiguidades.

  Por exemplo, suponha que o nó de ramificação C possua duas ramificações mutuamente exclusivas, C1 e C2, cada uma gravando na mesma tabela do MaxCompute com lógicas diferentes. O nó downstream B depende da saída dessa tabela. Nesse caso, use um nó de mesclagem J para consolidar as ramificações e faça o nó B depender de J. Se o nó B depender diretamente de C1 e C2, as ramificações mutuamente exclusivas causarão um problema: a ramificação não selecionada sempre terá o status Branch Not Selected. O nó B herdará esse status e também será ignorado. Esse comportamento se propaga para todos os nós downstream subsequentes.

Pré-requisitos

• Adicione o usuário RAM desejado ao seu workspace.

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

• Associe um grupo de recursos serverless ao seu workspace. Para mais detalhes, consulte os tópicos no diretório Use serverless resource groups.

• Crie um nó de mesclagem. Consulte Create nodes for a scheduling workflow para instruções.

Observações de uso

Os nós de mesclagem estão disponíveis apenas na DataWorks Standard Edition e em edições superiores. Para adquirir ou fazer upgrade, consulte DataWorks edition features.

Etapa 1: Desenvolver um nó de mesclagem

Após criar o nó de mesclagem, abra sua página de configuração 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. Pesquise pela saída, ID ou nome do nó.

2. Ao localizar um nó, clique no ícone para adicioná-lo à seção Merge Condition Settings.

   Nota

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

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), mas basta que qualquer nó de ramificação atenda ao seu status de execução configurado. Assim, o status definido em Result é aplicado ao nó atual.

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

     • Successful: Indica que o nó foi executado com sucesso.

     • Failed: Indica falha na execução do nó.

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

       Nota

       Este status se aplica somente 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

   Atualmente, 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 terminar a execução.

   • Configure o status de execução do nó Branch 2 como Successful ou Branch Not Running. Dessa forma, o nó Branch 2 terá concluído a execução e o Nó B não terá falhado.

   • Defina a condição da lógica de mesclagem como AND.

   O status de execução Successful do nó de mesclagem atual só entrará em vigor quando o nó Branch 1 concluir a execução e o nó Branch 2 também concluir 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 suas propriedades de agendamento. Para mais informações, consulte Configure scheduling properties for a node.

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 Deploy a node or workflow para detalhes.

2. Uma vez implantada, a tarefa executa periodicamente conforme a configuração de agendamento definida. 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 mais informações, consulte Get started with Operation Center.