Configurar Tarefas

Esta seção aborda a criação e a configuração de tarefas.

Tópicos:

• Sobre Tarefas
• Criar uma Tarefa Python
• Criar uma Tarefa de Notebook
• Criar uma Tarefa de Job Aninhada
• Criar uma tarefa If/Else
• Criar uma Tarefa Jar
• Modificar uma Tarefa
• Exibir Logs de Tarefas
• Excluir uma Tarefa
• Reparar Execuções de Job com Falha

Sobre Tarefas

As tarefas são blocos de código curtos e funcionais que você pode juntar em um fluxo como parte do trabalho ou promover para os próprios trabalhos.

As tarefas são os principais blocos de construção de todos os fluxos de trabalho no Oracle AI Data Platform Workbench. O tipo de tarefa determina o tipo de código que ela utiliza. Como parte de um job, você conecta tarefas para determinar sua sequência e prioridade quando o job é executado.

Tipo de tarefa	Descrição
Tarefa de notebook	Uma tarefa que foi salva em um notebook que você pode acessar
Tarefa Python	Uma tarefa usando um trecho de código da linguagem de programação Python
Condição If/else	Uma tarefa que usa condições if/else
Tarefa de tarefa aninhada	Uma tarefa que usa um job existente e suas tarefas como uma tarefa aninhada
Tarefa Jar	Uma tarefa que pode executar código Scala ou Java compilado em arquivos JAR (Java Archive).

Quando você tem mais de uma tarefa, é possível criar conjuntos de dependências de tarefa em que o sucesso ou a falha de uma tarefa pode acionar tarefas subsequentes em sequência. Você só pode criar dependências em jobs que tenham mais de uma tarefa. Consulte Criar uma Tarefa de Notebook.

As tarefas podem ser executadas em paralelo. É possível fazer isso tornando duas ou mais tarefas dependentes do sucesso ou da falha de outra tarefa no mesmo fluxo de trabalho, fazendo com que elas sejam executadas ao mesmo tempo.

As tarefas podem falhar devido a problemas transitórios, como interrupções na rede, indisponibilidade de recursos ou falhas temporárias no serviço. Nesses casos, o AI Data Platform Workbench repete automaticamente a tarefa com base nas políticas de repetição configuradas quando a tarefa é criada. Como parte dessas políticas, você define:

• Contagem de Repetições: O número máximo de tentativas de repetição.
• Intervalo de Repetição: O tempo de espera entre novas tentativas.

Além das novas tentativas de tarefa padrão, o AI Data Platform Workbench também oferece suporte a Repetir no timeout. Se uma tarefa exceder seu limite de tempo de execução devido a restrições de recursos ou processamento lento e você quiser tentar novamente apenas para esses cenários, poderá optar por acionar automaticamente uma nova tentativa. Essas políticas de repetição aumentam a resiliência do fluxo de trabalho, garantindo que as tarefas tenham uma chance maior de execução bem-sucedida sem intervenção manual.

Quando e Como Usar Logs de Computação

Verifique seus logs de computação se sua tarefa falhar com erros relacionados a recursos ou sistema, como erros de falta de memória ou uso da CPU excedendo os limites.

Revise os logs do Spark se você vir longos tempos de espera, novas tentativas inesperadas ou gargalos de desempenho do job. Esses logs fornecem informações sobre o driver e os nós de trabalho do cluster de computação que respaldam sua tarefa e podem ajudar a identificar a origem de possíveis problemas.

Para obter orientação sobre como verificar seus logs, consulte Monitorar uma Execução de Job Específica.

Você deve ter a permissão RBAC no nível de computação apropriada para exibir metadados e logs da instância de computação associada ao job. Entre em contato com o administrador para obter essas permissões caso não consiga exibir logs de computação. Para obter mais informações sobre Sobre Permissões.

Criar uma Tarefa Python

Você pode criar uma tarefa como parte do job de workflow que usa script Python.

1. Na Home page, clique em Workflow.
2. Clique no job para o qual deseja fazer uma tarefa.
3. Clique em Adicionar tarefa.
4. Informe um nome de tarefa.
5. Para Tipo de tarefa, selecione Python.
6. Clique em Procurar e navegue até o script Python que deseja adicionar como tarefa. Clique em Selecionar.
7. Selecione um cluster de computação para a tarefa Python, se ainda não houver um anexado.
8. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.
   
   

   

   
   
9. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
10. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma Tarefa de Notebook

Você cria tarefas usando notebooks que criou no AI Data Platform Workbench.

1. Na Home page, clique em Workflow.
2. Clique no job para o qual deseja fazer uma tarefa.
3. Clique em Adicionar tarefa.
4. Informe um nome de tarefa.
5. Para Tipo de tarefa, selecione Livro de Notas.
6. Clique em Procurar e navegue até o notebook que você deseja adicionar como tarefa. Clique em Selecionar.
7. Selecione um cluster de computação para a tarefa de notebook, se ainda não houver um anexado.
8. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.
   
   

   

   
   
9. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
10. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma Tarefa de Job Aninhada

Você pode usar outro job de workflow e suas tarefas contidas como uma tarefa aninhada em outro workflow.

1. Na Home page, clique em Workflow.
2. Clique no job para o qual deseja fazer uma tarefa.
3. Clique em Adicionar tarefa.
4. Informe um nome de tarefa.
5. Para Tipo de tarefa, selecione Tarefa de tarefa aninhada.
6. Na lista drop-down Jobs, selecione um job existente do qual você deseja fazer uma tarefa.
7. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.
   
   

   

   
   
8. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
9. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma tarefa If/Else

Você pode criar uma tarefa que use condições if/else com base nos dados do catálogo para determinar se a tarefa é acionada.

1. Na Home page, clique em Workflow.
2. Clique no job para o qual deseja fazer uma tarefa.
3. Clique em Adicionar tarefa.
4. Informe um nome de tarefa.
5. Para Tipo de tarefa, selecione Se/Outra.
6. Informe as condições que determinam se a tarefa é acionada. Clique em Adicionar para definir várias condições.
7. Informe a expressão da condição.
8. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.
   
   

   

   
   
9. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
10. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Criar uma Tarefa Jar

Você pode criar tarefas que executam o código Scala ou Java compilado em arquivos JAR (Java Archive).

Observação:

Os arquivos de biblioteca dependentes devem usar as versões do JDK, Scala ou Spark compatíveis com o runtime do cluster do Oracle AI Data Platform Workbench no momento da criação para evitar comportamento inesperado.

1. Na Home page, clique em Workflow.
2. Clique no job para o qual deseja fazer uma tarefa.
3. Clique em Adicionar tarefa.
4. Informe um nome de tarefa.
5. Para Tipo de tarefa, selecione Tarefa JAR.
6. Para Main class name, especifique o nome completo da classe que contém o método main que você deseja executar. Por exemplo, ProcessTransaction. Esta classe deve ser incluída em um dos arquivos adicionados como uma biblioteca dependente.
7. Para Bibliotecas dependentes, clique em Adicionar.
8. Selecione uma origem para seus arquivos de biblioteca dependentes. Pelo menos uma biblioteca que contenha o método de classe principal especificado acima deve ser incluída.
   • Para Espaço de Trabalho ou Volume, procure o espaço de trabalho ou volume do AI Data Platform Workbench, selecione o arquivo ou os arquivos que deseja adicionar como biblioteca e clique em Adicionar.
   • Para Fazer upload de arquivo no espaço de trabalho, procure na máquina local o(s) arquivo(s) a ser(em) carregado(s) como biblioteca e clique em Adicionar.
9. Em argumentos de linha de comando, forneça argumentos delimitados por espaços em branco que você deseja passar para a classe principal.
10. Selecione o número de novas tentativas que uma tarefa deve tentar em caso de falha. Se você selecionar mais de 0, também deverá especificar quanto tempo a execução do job deverá aguardar entre as novas tentativas e se as novas tentativas deverão ser feitas no tempo limite.
    
    

    

    
    
11. Em Depende de, selecione todas as tarefas das quais você deseja tornar essa tarefa dependente. Selecione a resposta condicional a essa dependência na lista suspensa Executar se.
12. Adicione parâmetros adicionais fornecendo suas Chave e Valor. Clique em Adicionar parâmetro para fornecer vários parâmetros.

Modificar uma Tarefa

Você pode alterar os atributos existentes de uma tarefa, como nome, tipo e parâmetros, para alterar como ela funciona no seu job.

1. Na Home page, clique em Workflow.
2. Clique no job para o qual deseja configurar tarefas.
3. Na guia Tarefas, clique na tarefa que deseja editar.
4. No painel Detalhes da Tarefa à direita, modifique os atributos da tarefa conforme necessário. As alterações são salvas automaticamente.

Exibir Logs de Tarefas

Você pode exibir os logs de execução de tarefas individuais em um job.

1. Na Home page, clique em Workflows.
2. Clique em Execuções de Jobs.
3. Clique no job cujos logs de tarefa você deseja ver.
4. Clique nos nós da tarefa para ver os logs dessa tarefa.

Excluir uma Tarefa

Você pode excluir uma tarefa removendo o nó da tarefa de um job.

1. Na Home page, clique em Workflow.
2. Clique no job do qual deseja excluir tarefas.
3. No nó da tarefa, clique em Ações e, em seguida, clique em Remover nó.
4. Clique em Excluir.