Todos os produtos
Search
Central de documentação

DataWorks:Executar testes e visualizar instâncias de teste

Última atualização: Nov 03, 2026

A execução de um teste em uma tarefa agendada gera uma instância de teste. Na página de instâncias de teste, visualize os detalhes da instância em lista ou em um DAG.

Introdução

Execute um teste em uma tarefa agendada e verifique se o agendamento e a execução atendem às expectativas no ambiente de produção. Essa ação gera uma instância de teste e permite monitorar o status de execução na página de instâncias de teste.

Nota

Executar uma instância de teste aciona a lógica real do código. Prossiga com cautela.

Limitações

  • Limitações de recursos:

    • O DataWorks Professional Edition e as edições superiores oferecem os seguintes recursos avançados para aumentar a eficiência de desenvolvimento e O&M. Para mais informações, consulte Editions and billing.

      • Análise avançada de DAG: Inclui agregação de nós, análise de upstream e de downstream para ajudar a obter insights sobre a linhagem de tarefas complexas.

      • Export Query Results: Permite o uso de dados em relatórios externos ou análises adicionais.

    • AI Diagnostics: Ajuda a localizar rapidamente problemas na execução de tarefas. Para usar esse recurso, ative o Data Agent. Para mais informações, consulte Data O&M Agent.

    • Somente usuários com permissões de O&M podem usar determinados recursos. Se um recurso estiver acinzentado ou indisponível, acesse a página Management Center overview. No painel de navegação à esquerda, clique em Workspace Members and Roles e, na guia Workspace Members, verifique se o usuário-alvo possui permissões de O&M. Para mais informações, consulte gerencie permissions for workspace-level modules.

  • Limitações de logs e instâncias:

    • Não exclua instâncias de teste manualmente. A plataforma as exclui automaticamente após a expiração (cerca de 30 dias). Se uma tarefa não precisar mais ser executada, congele a instância.

    • Em grupos de recursos compartilhados para agendamento, as instâncias são retidas por um mês (30 dias) e os logs, por uma semana (7 dias).

    • Em grupos de recursos exclusivos para agendamento, as instâncias de tarefa e os logs são retidos por um mês (30 dias).

    • Os logs de instâncias concluídas com mais de 3 MB são limpos diariamente.

  • Após a configuração do número máximo de instâncias simultâneas de uma tarefa, as instâncias de teste também ficam sujeitas a esse limite e compartilham a cota de simultaneidade com instâncias agendadas e de backfill. Quando vários tipos de instâncias entram na fila simultaneamente, apenas as instâncias de backfill que não são do dia atual têm a prioridade rebaixada (de 8 para 3).

Executar um teste e gerar uma instância de teste

  1. Acesse o Operation Center.

    Faça login no console do DataWorks. Na região de destino, clique em Data Development and O&M > Operation Center no painel de navegação à esquerda. Selecione um workspace na lista suspensa e clique em Go to Operation Center.

  2. Execute um teste em uma tarefa agendada.

    Na página Operation Center, no painel de navegação à esquerda, clique em Auto Triggered Task O&M > Auto Triggered Node. Na página Auto Triggered Node, execute um teste em uma tarefa agendada por meio de um dos métodos a seguir.

    • Método 1: Na visualização em lista de tarefas agendadas, clique em Test na coluna Actions da tarefa de destino. Se a página atual não estiver na visualização em lista, clique no ícone Arrow icon no meio da página para retornar a essa visualização.

    • Método 2: Na visualização em DAG, clique com o botão direito do mouse no DAG da instância de destino e selecione Test no menu de contexto. Se a página atual não estiver na visualização em DAG, clique em DAG na coluna Actions da instância de destino para abrir o DAG da tarefa.

  3. configure os parâmetros na caixa de diálogo Test.

    Parâmetro

    Descrição

    Test Name

    insira um nome para o teste de fumaça.

    Data Timestamp

    Selecione a data de negócio para o teste.

    Nota
    • Se selecionar uma data de negócio anterior a ontem, a tarefa será executada imediatamente.

    • Se selecionar ontem como data de negócio, a tarefa será executada no horário agendado.

    Advanced configuration

    Após ativar as configurações avançadas, atribua valores aos parâmetros de agendamento. Os valores atribuídos entram em vigor apenas para o teste atual.

Visualizar a lista de instâncias de teste

A lista exibe as instâncias de teste geradas após a execução de testes em tarefas agendadas. Visualize o status de execução das instâncias e execute operações relacionadas.

Operação

Descrição

Filter

Filtre as instâncias a serem consultadas por Node Name, Node ID, Task type, Run At, Data Timestamp, Scheduling Resource Group, My Node, The node I tested today e Pause (freeze) a node.

Nota

A data de negócio padrão para filtragem é o dia anterior à data atual.

Tasks

As instâncias de teste que atendem às condições de filtro são exibidas em lista.

Actions

Execute as seguintes operações nas instâncias de teste:

  • DAG: O DAG exibe as dependências de upstream e downstream de uma instância de teste. Execute operações relacionadas no DAG. Para mais informações, consulte gerencie DAGs.

  • AI Diagnostics: Abre o painel do Data O&M Agent no lado direito da página e envia automaticamente a instrução de diagnóstico da instância atual para analisar a tarefa. Quando uma tarefa não for executada conforme o esperado, use este recurso para localizar o problema. Para mais informações, consulte Data O&M Agent.

  • Rerun: Execute novamente uma tarefa bem-sucedida ou que falhou. Após a execução bem-sucedida, a tarefa pode acionar o agendamento de tarefas de downstream no estado não executado. Esse recurso é comumente usado para lidar com nós que falharam ou foram omitidos.

    Nota

    É possível executar novamente apenas tarefas no estado Successful ou Failed.

  • More:

    • Rerun Descendent Nodes: Execute novamente nós de downstream de uma tarefa bem-sucedida ou que falhou. Selecione as tarefas de downstream a serem executadas novamente. Após a execução bem-sucedida, a tarefa pode acionar o agendamento de tarefas de downstream no estado não executado. Esse recurso é comumente usado para reparo de dados.

      Nota

      É possível executar novamente apenas tarefas no estado Successful ou Failed. Se selecionar tarefas em outros estados, a página exibirá a mensagem The Selected Nodes Include Nodes That Do Not Meet the Run Conditions e o envio da execução será bloqueado.

    • Set to Successful: Defina uma tarefa que falhou para o estado de sucesso. Quando uma tarefa falha, mas não deve bloquear as tarefas de downstream, use este recurso. É comumente usado para lidar com nós que falharam.

    • Terminate: Encerre uma tarefa que não precisa mais ser executada. Após o encerramento, a tarefa sai com status de falha.

      Nota

      É possível encerrar apenas instâncias no estado Waiting time, Waiting for resources ou Running.

    • Freeze: Use este recurso quando uma tarefa e suas tarefas de downstream não precisarem ser executadas por um período. Para mais informações, consulte Freeze and unfreeze instances.

      Nota

      Não execute operações no nó projectname_root. Este é o nó raiz do workspace e todas as instâncias de tarefas agendadas dependem dele. Se congelar este nó, as instâncias de tarefas agendadas não poderão ser executadas.

    • Unfreeze: Descongele uma instância que está no estado congelado.

      • Se a instância ainda não foi executada, ela será executada automaticamente após a conclusão das tarefas de upstream.

      • Se todas as tarefas de upstream tiverem terminado a execução, a instância será definida diretamente para o estado de falha. Execute-a novamente de forma manual para que a instância seja executada normalmente.

      Nota

      A operação de descongelamento aplica-se apenas à instância específica. Se a tarefa agendada ainda estiver no estado congelado, as instâncias geradas no dia seguinte permanecerão nesse estado.

    • View Lineage: Visualize as informações de linhagem da instância atual.

    • View cycle task details: Visualize as informações básicas da instância atual.

    • View Runtime Log: Após o início da execução de uma tarefa, visualize o processo de execução detalhado no log de execução. Para descrições dos parâmetros principais nos logs, consulte Runtime log parameters.

Operações em lote

Selecione várias tarefas em lotes e execute operações como Terminate, Rerun, Set to Successful, Change Resource Group, Freeze, Unfreeze e Export Query Results.

Itens por página

Altere o número de itens exibidos por página. O limite é de 200 itens por página.

DAG da instância de teste

Na visualização em lista, clique no nome da Test Instance ou em DAG na coluna Actions para abrir o DAG da instância. Clique com o botão direito do mouse em uma instância no DAG para executar operações relacionadas.

Recurso

Descrição

Recursos do painel de DAG

Clique em DAG ao lado de uma tarefa para abrir seu DAG. Execute as seguintes operações no DAG:

  • Search: Filtre instâncias por Node Name, Node ID, Instance ID, Instance Name, entre outros.

  • Select DAG Display Style: Clique nos ícones de recursos no canto superior direito da visualização em DAG para ajustar o estilo de exibição conforme necessário. Da esquerda para a direita: Open Map/Close Map, Show Alert Status/Hide Alert Status, Update Node Status, Zoom In DAG canvas, Zoom Out DAG canvas, proporção de layout 1:1 entre nós e canvas, Automático Fit Screen com base no tamanho atual da janela e Toggle Full Screen View alternar.

Operações de instância única

Clique com o botão direito do mouse no nó de destino para executar operações relacionadas.

  • Terminate: Encerre uma tarefa que não precisa mais ser executada. Após o encerramento, a tarefa sai com status de falha.

  • Rerun: Execute novamente uma tarefa bem-sucedida ou que falhou.

    Na caixa de diálogo de confirmação, a opção Rerun With Latest Configuration vem desativada por padrão. Se ativada, as seguintes propriedades da instância de teste serão atualizadas para as configurações mais recentes da tarefa: recurso de computação, grupo de recursos, CUs, prioridade, imagem, tipo de agendamento, política de nova execução, definição de tempo limite, proprietário, tags e configurações de DQC. Se a configuração do nó foi modificada após a geração da instância de teste, ative essa opção para executar a instância novamente com a configuração mais recente. Independentemente de essa opção estar ativada, o código do nó sempre usa a versão mais recente em cada nova execução.

    Importante

    Se as propriedades da instância foram modificadas manualmente, não ative essa opção. As alterações nas propriedades da instância podem ser redefinidas.

  • More: Expande o menu para incluir operações como Set to Successful e Freeze.

Nota

Para outras operações, consulte View the list of test instances.

Detalhes de instância única

Execute as seguintes operações:

  • View Log Data: Após o início da execução de uma tarefa, visualize o processo de execução detalhado no log de execução. Para descrições dos parâmetros principais nos logs, consulte Runtime log parameters.

  • Show Details: Visualize informações sobre a tarefa atual, incluindo propriedades, contexto, log de execução, log de operações e código. Para mais informações, consulte View instance details.

Visualizar os detalhes da instância

Na visualização em DAG, clique na instância de destino. Na janela exibida no canto inferior direito, clique em Show Details. A página de detalhes da instância será aberta, permitindo visualizar informações detalhadas sobre a instância atual, incluindo propriedades, contexto, log de execução, log de operações e código.

Recurso

Descrição

General

General: Nesta guia, visualize as propriedades de agendamento da tarefa no ambiente de produção. Para descrições dos parâmetros na página, consulte configure schedule settings.

  • Interpretação do status da tarefa: O status está relacionado à execução da tarefa. Se uma tarefa estiver no estado não executado, aguardando horário, aguardando recursos ou congelada, consulte Troubleshoot task status issues para solução de problemas.

  • Tempo gasto aguardando recursos: Se uma tarefa aguardar recursos por muito tempo, use o recurso run diagnostics para identificar quais tarefas estão ocupando recursos durante a execução da tarefa atual e localizar rapidamente tarefas anômalas para solução de problemas.

  • Duração excessiva: Se a duração da tarefa for significativamente maior em comparação com execuções anteriores, consulte os seguintes cenários para solução de problemas.

    • Tarefas de não sincronização: Entre em contato com o responsável pelo mecanismo de computação correspondente.

    • Tarefas de sincronização em lote: Uma fase específica da tarefa pode estar sendo executada lentamente, ou a tarefa pode estar travada em um estado prolongado de espera por recursos. Para mais informações, consulte Troubleshoot batch synchronization tasks.

  • Regras de monitoramento: Visualize as regras de monitoramento associadas à instância atual. Clique em Create no lado direito para criar rapidamente uma regra de monitoramento para o status de execução da tarefa. Para mais informações, consulte Create a monitoring rule.

    Nota

    Apenas as regras de monitoramento para o status de execução da tarefa podem ser visualizadas aqui. Regras de monitoramento de Data Quality não são suportadas.

  • Monitoramento de linha de base: Visualize as linhas de base associadas à instância atual. Clique em Create no lado direito para criar rapidamente uma linha de base. Para mais informações, consulte gerencie baselines.

  • Número máximo de instâncias simultâneas: Exibe o número máximo de instâncias simultâneas configuradas para a tarefa. O valor é Unlimited ou um número específico (1 a 10000). Essa configuração limita o número máximo de instâncias da mesma tarefa que podem ser executadas simultaneamente. O limite aplica-se a instâncias agendadas, instâncias de backfill e instâncias de teste.

Runtime Log

Runtime Log: Após o início da execução de uma tarefa, visualize o processo de execução detalhado no log de execução. Para descrições dos parâmetros principais nos logs, consulte Runtime log parameters.

Operation Log

Operation Log: Visualize os registros de operação de uma tarefa ou instância, incluindo o horário, o operador e a operação específica.

Code

Code: Visualize o código mais recente da tarefa atual no ambiente de produção. Se o código não atender às expectativas, verifique se a versão mais recente da tarefa foi implantada com sucesso. Para mais informações, consulte Deploy nodes.

Solucionar problemas de execução de tarefas

Se uma tarefa não for executada conforme o esperado, use o recurso run diagnostics para diagnosticar os motivos pelos quais a tarefa não foi executada ou identificar problemas.