Todos os produtos
Search
Central de documentação

DataWorks:Executar testes e visualizar instâncias de teste

Última atualização: Jun 27, 2026

Uma instância de teste é gerada ao executar um teste em uma tarefa agendada. Na página de instâncias de teste, visualize os detalhes da instância em lista ou DAG.

Introdução

Execute testes em tarefas agendadas para verificar se o agendamento e a execução atendem às expectativas no ambiente de produção. Essa ação gera uma instância de teste, permitindo monitorar seu status de execução na página de instâncias de teste.

Nota

A execução de uma instância de teste aciona a lógica real do código. Proceda com cautela.

Limitações

  • Limitações de recursos:

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

      • Run Diagnostics: Auxilia na localização rápida de problemas na execução de tarefas. Este recurso está disponível para avaliação gratuita. Para mais informações, consulte diagnóstico inteligente.

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

      • Export Query Results: Permite utilizar dados para relatórios externos ou análises adicionais.

    • Apenas usuários com permissões de O&M podem utilizar determinados recursos. Caso um recurso apareça esmaecido ou indisponível, acesse a página Visão geral do Management Center. No painel de navegação à esquerda, clique em Workspace Members and Roles e, na aba Workspace Members, verifique se o usuário alvo possui permissões de O&M. Para mais informações, consulte Gerenciar permissões para módulos no nível de workspace.

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

    • Não é possível excluir instâncias de teste manualmente. A plataforma exclui automaticamente as instâncias após o vencimento (aproximadamente 30 dias). Caso uma tarefa não precise 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 tarefas e os logs são retidos por um mês (30 dias).

    • Logs de instâncias concluídas que excedem 3 MB são limpos diariamente.

  • Após configurar o número máximo de instâncias simultâneas para 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 instâncias de backfill. Quando múltiplos tipos de instâncias estão na fila simultaneamente, apenas as instâncias de backfill que não são do dia atual têm sua 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 desejada, 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 o teste na tarefa agendada utilizando um dos métodos abaixo.

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

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

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

    Parâmetro

    Descrição

    Test Name

    Insira um nome para o teste de fumaça.

    Data Timestamp

    Selecione a data de negócios para o teste.

    Nota
    • Ao selecionar uma data de negócios anterior a ontem, a tarefa é executada imediatamente.

    • Ao selecionar ontem como data de negócios, a tarefa é executada no horário agendado.

    Advanced configuration

    Ao ativar as configurações avançadas, atribua valores aos parâmetros de agendamento. Os valores atribuídos têm efeito apenas no teste atual.

Visualizar a lista de instâncias de teste

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

List icon

Operação

Descrição

Filter

Na área 1 da figura anterior, utilize condições de filtro para localizar as instâncias desejadas.

Filtre as instâncias 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ócios padrão para filtragem é o dia anterior à data atual.

Tasks

Na área 2 da figura anterior, as instâncias de teste que atendem às condições de filtro são exibidas em lista.

Actions

Na área 3 da figura anterior, realize as seguintes operações nas instâncias de teste:

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

  • Diagnostics (Run Diagnostics): Realiza análises ponta a ponta em uma tarefa. Utilize este recurso para localizar problemas quando uma tarefa não for executada conforme o esperado. Para mais informações, consulte Diagnóstico inteligente.

  • Rerun: Reexecuta uma tarefa com status de sucesso ou falha. Após a execução bem-sucedida, a tarefa pode acionar o agendamento de tarefas downstream que estejam no estado de não executado. Uso comum para tratar nós com falha ou perdidos.

    Nota

    Somente tarefas nos estados Successful ou Failed podem ser reexecutadas.

  • More:

    • Rerun Descendent Nodes: Reexecuta nós downstream de uma tarefa com status de sucesso ou falha. Selecione as tarefas downstream a serem reexecutadas. Após a execução bem-sucedida, a tarefa pode acionar o agendamento de tarefas downstream que estejam no estado de não executado. Uso comum para reparo de dados.

      Nota

      Somente tarefas nos estados Successful ou Failed podem ser reexecutadas. Ao 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: Define uma tarefa com falha como bem-sucedida. Utilize este recurso quando uma tarefa falhar, mas não deve bloquear as tarefas downstream. Uso comum para tratar nós com falha.

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

      Nota

      Somente instâncias nos estados Waiting time, Waiting for resources ou Running podem ser encerradas.

    • Freeze: Utilize este recurso quando uma tarefa e suas tarefas downstream não precisarem ser executadas por um período. Para mais informações, consulte Congelar e descongelar instâncias.

      Nota

      Não realize operações no nó projectname_root. Este é o nó raiz do workspace. Todas as instâncias de tarefas agendadas dependem dele. O congelamento deste nó impede a execução das instâncias de tarefas agendadas.

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

      • Caso a instância ainda não tenha sido executada, ela será executada automaticamente após a conclusão das tarefas upstream.

      • Se todas as tarefas upstream já tiverem concluído a execução, a instância será definida diretamente como falha. Reexecute-a manualmente para que funcione 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 congeladas.

    • 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 seu processo detalhado no log de execução. Para descrições dos principais parâmetros nos logs, consulte Parâmetros do log de execução.

Operações em lote

Na área 4 da figura anterior, selecione várias tarefas em lote e realize operações como Terminate, Rerun, Set to Successful, Change Resource Group, Freeze, Unfreeze e Export Query Results.

Itens por página

Na área 5 da figura anterior, altere o número de itens exibidos por página. O limite máximo é de 200 itens por página.

DAG de instância de teste

Na exibição de 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 em uma instância no DAG para realizar operações relacionadas. DAG diagram

Recurso

Descrição

Recursos do painel DAG

Clique em DAG ao lado de uma tarefa para abrir seu DAG. As seguintes operações estão disponíveis no DAG:

  • Search: Na área 1 da figura anterior, filtre instâncias por Node Name, Node ID, Instance ID, Instance Name, entre outros.

  • Select DAG Display Style: Na área 2 da figura anterior, clique nos ícones de recursos no canto superior direito da visualização do 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 tela, Ajuste automático Fit Screen com base no tamanho atual da janela e Toggle Full Screen View alternar.

Operações em instância única

Clique com o botão direito no nó alvo para realizar operações relacionadas.

  • View Code: Verifica o código do nó atual no ambiente de produção. Se o código não atender às expectativas, confirme se a versão mais recente do nó foi implantada com sucesso.

  • Edit Node: Clique para acessar a página do Data Studio e abrir o nó atual.

Nota

Para outras operações, consulte Visualizar a lista de instâncias de teste.

Detalhes de instância única

Na área 4 da figura anterior, realize as seguintes operações:

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

  • 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 Visualizar detalhes da instância.

Visualizar detalhes da instância

Na visualização do DAG, clique na instância alvo. 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.

View instance details

Recurso

Descrição

General

Nesta aba, visualize as propriedades de agendamento da tarefa no ambiente de produção. Para descrições dos parâmetros na página, consulte Configurar definições de agendamento.

  • Interpretação do status da tarefa: O status está relacionado à execução da tarefa. Caso uma tarefa esteja nos estados não executado, aguardando horário, aguardando recursos ou congelado, consulte Solucionar problemas de status de tarefas para troubleshooting.

  • Tempo de espera por recursos: Se uma tarefa estiver aguardando recursos por muito tempo, utilize o recurso de diagnóstico inteligente para identificar quais tarefas estão ocupando recursos durante a execução da tarefa atual e localizar rapidamente tarefas anômalas para troubleshooting.

  • Duração excessiva: Se a duração da tarefa for significativamente maior em comparação com execuções históricas, consulte os cenários abaixo para troubleshooting.

    • Tarefas sem 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 lenta ou a tarefa pode estar presa em um estado prolongado de espera por recursos. Para mais informações, consulte Solucionar problemas de tarefas de sincronização em lote.

  • 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 Criar uma regra de monitoramento.

    Nota

    Apenas regras de monitoramento para status de execução de tarefas podem ser visualizadas aqui. Regras de monitoramento de Qualidade de Dados 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 Gerenciar linhas de base.

  • Número máximo de instâncias simultâneas: Exibe o número máximo de instâncias simultâneas configurado para a tarefa. O valor é Unlimited ou um número específico (1 a 10000). Esta 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

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

Operation Log

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

Code

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

Solucionar problemas de execução de tarefas

Caso uma tarefa não seja executada conforme o esperado, utilize o recurso de diagnóstico inteligente para diagnosticar os motivos pelos quais a tarefa não foi executada ou identificar problemas.