Tarefa de script em Python para trabalhos

Usa a tarefa Python script para executar um ficheiro Python.

Requirements

  • Deve carregar o seu script Python para um local acessível ao utilizador que está a configurar o trabalho. O Databricks recomenda usar ficheiros workspace para scripts Python. Consulte O que são arquivos de espaço de trabalho?.

Configurar uma tarefa de script Python

Note

A interface de trabalhos exibe opções dinamicamente com base em outras configurações.

A Databricks recomenda não armazenar código ou dados na raiz ou em montagens do DBFS. Em vez disso, você pode migrar scripts Python para arquivos ou volumes de espaço de trabalho ou usar URIs para acessar o armazenamento de objetos na nuvem.

Para iniciar o fluxo de configuração de uma tarefa Python script:

  1. Navegue para o separador Tarefas na UI de Trabalhos.
  2. Clique no ícone Mais. Adicionar tarefa.
  3. Insira um nome no campo Nome da tarefa .
  4. No menu suspenso do Tipo , selecione Python script.

Configurar a origem

No menu drop-down Source, selecione um destino para o script Python usando uma das seguintes opções.

Workspace

Use Workspace para configurar um script Python armazenado usando ficheiros workspace.

  1. Clique no campo Caminho . Aparece o diálogo Select Python File.
  2. Navegue até ao script Python, clique para destacar o ficheiro e clique em Confirmar.

Note

Pode usar esta opção para configurar uma tarefa num script Python armazenado numa pasta Databricks Git. O Databricks recomenda o uso da opção de provedor Git e um repositório Git remoto para versionar ativos com trabalhos agendados.

DBFS/ADLS

Use DBFS/ADLS para configurar um script Python armazenado num volume, numa localização de armazenamento de objetos na nuvem ou na raiz do DBFS.

O Databricks recomenda armazenar scripts Python em volumes do Unity Catalog ou armazenamento de objetos na nuvem.

No campo Path, introduza o URI do seu script de Python. Por exemplo, dbfs:/path/to/script.py ou abfss://container-name@storage-account-name.dfs.core.windows.net/path/to/script.py.

Fornecedor Git

Utilize o provedor Git para configurar um script Python armazenado num repositório Git remoto.

As opções exibidas pela interface do usuário dependem se você já configurou ou não um provedor Git em outro lugar. Apenas um repositório Git remoto pode ser usado para todas as tarefas em um trabalho. Veja Usar o Git com Lakeflow Jobs.

O campo Caminho aparece depois de configurar uma referência Git.

Introduza o caminho relativo do seu script de Python, como etl/bronze/ingest.py.

Importante

Ao inserir o caminho relativo, não comece com / ou ./. Por exemplo, se o caminho absoluto para o código Python que você deseja acessar for /etl/bronze/ingest.py, digite etl/bronze/ingest.py no campo Caminho .

Configurar recursos de computação e bibliotecas dependentes

  1. Use Compute para selecionar ou configurar um cluster que ofereça suporte à lógica no seu script.
  2. Se utilizar a computação Serverless, use o campo Ambiente e Bibliotecas para selecionar, editar ou adicionar um novo ambiente. Consulte Configurar o ambiente sem servidor.
  3. Para todas as outras configurações de computação, clique no ícone Plus.Adicione em Bibliotecas Dependentes. A caixa de diálogo Adicionar biblioteca dependente é exibida.
    • Você pode selecionar uma biblioteca existente ou carregar uma nova biblioteca.
    • Você só pode usar bibliotecas armazenadas em um local suportado por suas configurações de computação. Veja suporte da biblioteca Python.
    • Cada fonte de biblioteca tem um fluxo diferente para selecionar ou carregar uma biblioteca. Consulte Instalar bibliotecas.

Finalizar a configuração do trabalho

  1. (Opcional) Configure Parameters como uma lista de cadeias de caracteres passadas como argumentos CLI para o script Python. Consulte Configurar parâmetros de tarefa.
  2. (Opcional) Para configurar tentativas, limiares para a duração da execução ou para o backlog de streaming, ou notificações, consulte Definições avançadas da tarefa.
  3. Clique em Salvar tarefa.

Para editar, clonar, desativar ou eliminar esta tarefa, consulte Configurar e editar tarefas em Lakeflow Jobs.

Recursos adicionais