DataWorks:Depurar nós e workflows

Pré-requisito

É necessário ter desenvolvido um nó. Para mais informações, consulte Data Studio.

Contexto

Escolha entre depurar um único nó ou depurar um workflow. Após a execução, visualize os resultados no Operating history ou use o recurso de consulta ad hoc para visualizar e processar os resultados da consulta.

• A depuração de um único nó ou workflow não gera cobrança por recursos de agendamento do DataWorks, mas há cobrança pelos mecanismos de computação utilizados. Para mais informações sobre as taxas dos mecanismos de computação, consulte a documentação de faturamento do respectivo mecanismo.

• Consultas com aceleração têm tempo máximo de execução de 1 hora.

Depurar um único nó

1. Acesse a página Data Studio. No painel de navegação à esquerda, em Data Development ou Manually Triggered Workflow, localize o workflow desejado e clique duas vezes no nó a ser editado.

2. Execute o nó para depurá-lo.

   Na aba do editor do nó, use Run ou Run with Parameters na barra de ferramentas para depurar a lógica do código. Também é possível usar Quick run para depurar um trecho de código. A tabela a seguir descreve cada opção.

   Nota

   Caso não tenha permissões para consultar os dados desejados ao executar um nó, consulte Visão geral do gerenciamento de permissões para mecanismos de computação e dados para entender o controle de permissões dos diferentes mecanismos de computação no DataWorks.

   Opção de execução	Descrição	Caso de uso
   Run (ícone )	Permite atribuir valores a variáveis e especificar um grupo de recursos para teste. O sistema salva essas configurações para execuções futuras. Nota Ao executar um nó recém-criado pela primeira vez, uma caixa de diálogo de configuração é exibida. Atribua manualmente valores constantes às variáveis no código. O DataWorks salva os valores atribuídos e usa essa configuração por padrão nas próximas execuções do nó.	Ideal para depuração frequente de código.
   Run with Parameters (ícone )	Exige a atribuição de valores constantes às variáveis do cenário de teste e a especificação de um grupo de recursos a cada execução do nó.	Recomendado para modificar valores de variáveis no código ou alterar o grupo de recursos da tarefa.
   Quick run (ícone )	Depura um trecho de código diretamente na área de código da aba do editor do nó.	Indicado para depurar apenas um trecho específico de código em um nó. Nota Este recurso valida apenas a correção de um trecho de código. Para depurar a lógica completa, use Run ou Run with Parameters.

Depurar um workflow

1. Acesse a página Data Studio. No painel de navegação à esquerda, em Data Development ou Manually Triggered Workflow, clique duas vezes no workflow desejado para abrir seu painel.

2. Depure o workflow.

   Clique em no botão Run () na barra de ferramentas do painel do workflow para executar todas as tarefas sequencialmente, conforme suas dependências.

   Também é possível clicar com o botão direito em um nó no painel do workflow e selecione Run Node and Downstream Nodes para executar esse nó e todos os seus nós downstream, respeitando as dependências.

   A execução pela barra de ferramentas e a opção Run Node and Downstream Nodes funcionam de maneiras diferentes:

   • Execução pela barra de ferramentas: Executa todos os nós sequencialmente, de upstream para downstream, com base no DAG completo do workflow. Cada nó é enviado para execução independentemente, o que equivale a executá-lo individualmente em sua aba de editor.

   • Clique com o botão direito em Run Node and Downstream Nodes: Inicia a partir do nó selecionado e executa o nó e seus downstreams aplicando a lógica de agendamento de dependências. Essa opção valida o status de execução e a saída dos nós upstream, diferentemente da execução direta na aba do editor (modo de depuração independente).

   Se ocorrer um erro ao usar Run Node and Downstream Nodes, mas o mesmo SQL for executado com sucesso na aba do editor do nó, isso acontece porque a execução via clique com o botão direito aplica a lógica de agendamento de dependências para validar o status e os dados de saída dos nós upstream. Já a execução direta roda apenas o código SQL do nó atual. Solucione o problema da seguinte forma:

   • Verifique o status de execução dos nós upstream. A execução via clique com o botão direito valida as dependências upstream. Se um nó upstream não tiver sido executado ou tiver falhado, o nó atual reportará um erro. Visualize os ícones de status de execução dos nós upstream no painel do workflow para confirme se todos foram executados com sucesso.

   • Revise as configurações de dependência entre os nós. Verifique se a passagem de parâmetros de entrada e saída está correta e se as atribuições de parâmetros de agendamento correspondem ao esperado. Na página de configurações de agendamento do nó, confirme se as tabelas de saída upstream correspondem às tabelas de entrada do nó atual.

   • Clique com o botão direito no nó com erro, selecione a opção para visualizar os logs de execução e localize a mensagem de erro específica. O log geralmente contém a causa exata, como tabela inexistente, permissões insuficientes ou erros de sintaxe.

   • Verifique problemas de sintaxe de comentários no código SQL. Alguns mecanismos analisam comentários de forma diferente no modo de agendamento em comparação à execução direta, o que pode causar erros de sintaxe. Para solucionar, tente remover comentários de bloco (/* */) do código SQL, mantendo apenas comentários de linha (--), e verifique se o erro persiste.

   • Confirme se os dados de saída dos nós upstream estão prontos. A execução via clique com o botão direito depende das tabelas de dados produzidas pelos nós upstream como entrada. Se um nó upstream tiver sido executado com sucesso, mas seus dados de saída ainda não estiverem prontos ou tiverem sido limpos, o nó atual reportará um erro por não conseguir ler a tabela de entrada.

   Nota

   • Se os nós em um workflow acionado manualmente tiverem variáveis com o mesmo nome e essas variáveis puderem ser atribuídas uniformemente, defina parâmetros de workflow no painel do workflow e atribua valores aos parâmetros. Em seguida, execute o workflow para visualizar os resultados da atribuição e o status de execução das tarefas manuais.

   • Apenas alguns tipos de nó suportam parâmetros de workflow. Consulte a interface para obter detalhes.

   • Após a conclusão da execução, clique com o botão direito em um nó no painel do workflow para visualizar os logs de execução desse nó.

Visualizar o histórico de operações

Acesse a página Operating history no Data Studio para visualizar todos os registros de tarefas executadas pela conta de login atual no Data Studio nos últimos três dias.

O Data Studio envia a tarefa ao mecanismo correspondente para processamento após a execução. Mesmo que você feche acidentalmente a tarefa durante a execução, ela continua em andamento. Acesse a página Operating history para visualizar os logs de execução ou interromper tarefas já enviadas para execução.

Criar um arquivo de consulta ad hoc

Processar resultados de consulta