Tarefa desativada em Empregos LakeFlow

Uma tarefa desativada em um LakeFlow Job Databricks LakeFlow é ignorada durante a execução, sem ser removida do Job. As tarefas desativadas mantêm sua configuração e histórico de execução, permitindo que você as reative posteriormente sem precisar recriá-las. Esta página explica como as tarefas desabilitadas se comportam durante a execução de um trabalho, incluindo seu efeito na tarefa posterior, reparos e execução parcial.

Comportamento da tarefa a jusante

Quando uma tarefa é executada, LakeFlow Jobs avalia a condição de execução de cada tarefa downstream em relação à sua tarefa upstream para decidir se deve executar, ignorar ou desabilitar a tarefa. Tarefa desativada concluída com código de término Disabled .

Se a condição de execução de uma tarefa downstream não puder ser atendida porque uma ou mais tarefas pai estão desativadas, LakeFlow Jobs também marcará a tarefa downstream como desativada para essa execução. Tarefa downstream desativada mostra um No canto superior direito da view do Gráfico Acíclico Direcionado (DAG), para que você possa ver o impacto antes de iniciar uma execução.

A tabela a seguir resume o comportamento subsequente para cada condição de execução quando uma tarefa anterior está desativada. Para obter a lista completa de opções de execução , consulte Configurar dependências de tarefas.

execução se condição	Comportamento da tarefa subsequente quando uma tarefa pai está desativada.	Exemplo
Todos tiveram sucesso (default)	A tarefa a jusante não é executada. Uma tarefa pai desativada não satisfaz o requisito succeeded .	A (disabled) → B: B não executa.
Pelo menos um bem-sucedido	A execução da tarefa a jusante se pelo menos uma outra tarefa pai for bem-sucedida. Se todas as outras tarefas pai falharam ou foram desativadas, a tarefa posterior não será executada.	A (disabled) e C (succeeded) → B: B execução.
Não houve falha	A execução da tarefa subsequente ocorre se pelo menos uma tarefa pai for concluída sem falhas. Se todas as tarefas pai estiverem desativadas, a tarefa posterior não será executada.	A (disabled) e C (skipped) → B: B execução porque nenhuma tarefa pai falhou.
Tudo pronto	A execução da tarefa downstream normalmente. Uma tarefa parental desativada é considerada concluída.	A (disabled) → B: B execução.
Pelo menos uma falha	A execução da tarefa downstream se pelo menos uma outra tarefa pai falhar. Uma tarefa principal desativada não é considerada uma falha. Se nenhuma outra tarefa principal falhar, a tarefa posterior não será executada.	A (disabled) e C (failed) → B: B execução.
Tudo falhou	A tarefa a jusante não é executada. Uma tarefa principal desativada não é considerada uma falha.	A (disabled) → B: B não executa.

nota

Apenas as tarefas que você desabilita explicitamente têm disabled: true na definição do trabalho. LakeFlow Jobs determina a desativação de serviços downstream no momento da criação da execução e não a armazena nas configurações do Job.

Desativar uma tarefa

Para desativar ou reativar uma tarefa usando a interface do usuário, consulte Desativar uma tarefa.

Para desativar uma tarefa por meio da API ou de um pacote:

Defina disabled: true na tarefa nas configurações do Job usando a API REST de Jobs, a CLI Databricks , o SDK Databricks ou um Declarative Automation Bundles:

JSON

{
  "tasks": [
    {
      "task_key": "load_raw_data",
      "disabled": true,
      "notebook_task": {
        "notebook_path": "/Shared/etl/load_raw_data"
      }
    }
  ]
}

As respostas jobs/get e jobs/list retornam disabled: true apenas para tarefas que você desativou explicitamente. tarefas desativadas dinamicamente durante uma execução não são refletidas nas configurações de trabalho armazenadas.

Tarefa deficiente em reparos e execução parcial

A tarefa deficiente comporta-se de maneira diferente na execução de reparo e na execução parcial do que em uma execução programada típica:

• Reparos: LakeFlow Jobs usa o estado de execução de cada tarefa para determinar o que reparar, e não o estado desativado da tarefa. Para forçar a execução de uma tarefa desativada como parte de um reparo, inclua-a em rerun_tasks na solicitação de reparo. Veja Re-execução falhou e tarefa ignorada.
• Execução parcial: As tarefas desativadas não são selecionadas por default quando você inicia uma execução parcial, mas você pode selecioná-las para execução uma vez sem reativá-las nas configurações do trabalho. LakeFlow Jobs executa exatamente a tarefa que você seleciona e não aplica execução se propagação durante uma execução parcial.

Limitações

Tarefas desativadas têm as seguintes limitações:

• Uma tarefa If/else condition falha se a tarefa upstream que fornece seu valor de condição estiver desativada.
• Uma tarefa For each falha se a tarefa upstream que fornece seus valores de entrada estiver desativada.
• Apenas as tarefas desativadas pelo usuário aparecem como disabled: true na definição do trabalho. Para ver quais tarefas subsequentes serão afetadas antes de executar o Job, use a view DAG na interface do usuário de Jobs.