Documentação do Oracle Cloud Infrastructure

Criando uma Programação de Tarefa

Crie uma programação de tarefa no Data Integration para a tarefa que você deseja executar em uma programação automatizada.

Você cria uma programação de tarefa para executar a tarefa em dias e horários específicos e em uma frequência específica. Uma programação de tarefa deve estar associada a uma programação existente. É possível ativar ou desativar uma programação de tarefa a qualquer momento.

As opções de execução que você pode definir para uma programação de tarefa são as seguintes:

  • A data e hora iniciais da execução e a data e hora finais. Informe uma data e hora de término específicas se quiser que a execução de uma tarefa programada continue além da data de término padrão, que é três meses a partir da data de criação de uma programação de tarefa.
  • O tempo estimado para a conclusão de uma execução.
  • O número de vezes para repetir uma execução quando uma execução falha.

No Data Integration, por padrão, você pode ter execuções de tarefas simultâneas ou paralelas de uma tarefa em um determinado momento. Para não permitir execuções de tarefa simultâneas por uma programação de tarefa, marque a caixa de seleção desativar execução simultânea ao criar a programação de tarefa. Quando a caixa de seleção é marcada, qualquer execução programada da tarefa pela programação da tarefa é ignorada se a execução da tarefa programada que foi acionada anteriormente ainda estiver em execução.

Se você estiver criando uma programação de tarefa para um pipeline que inclua tarefas configuradas para execução no serviço OCI Data Flow, use o seguinte formato se estiver editando os valores de parâmetro padrão para OCI_DF_LOG_BUCKET e OCI_DF_ARTIFACT_BUCKET: oci://<bucket-name>@<tenancy-name>

    1. Na página de lista Aplicativos, selecione o nome do aplicativo que contém a tarefa que você deseja programar. Se precisar de ajuda para localizar a página de lista ou o aplicativo, consulte Listando Aplicativos
    2. Na página Detalhes do aplicativo, selecione Tarefas.
    3. Na lista de tarefas, selecione Programar no menu Ações (Menu Ações) da tarefa que você deseja executar em uma programação automatizada.
    4. Na página Criar programação de tarefa, digite um nome e uma descrição (opcional).

      O identificador é um valor gerado pelo sistema com base no nome. Você pode alterar o valor, mas depois de criar e salvar a programação de tarefa, não será possível atualizar o identificador.

    5. Marque a caixa de seleção Ativar programação de tarefa para permitir que essa programação de tarefa acione execuções automatizadas quando as condições de programação forem atendidas.
    6. Marque a caixa de seleção Desativar a execução simultânea da tarefa por meio da programação para não permitir execuções simultâneas da tarefa pela programação da tarefa.
    7. Na seção Programar, selecione Selecionar para associar essa programação a uma programação.
    8. Na página Selecionar programação, execute uma das ações a seguir e selecione Selecionar.
      • Selecione uma programação existente no aplicativo.
      • Selecione Criar programação para criar uma programação e depois selecione a nova programação. Consulte Criando uma Programação se precisar de ajuda.
    9. Na página Criar programação da tarefa, na seção Configurar programação da tarefa, selecione Configurar para especificar as opções de execução desta programação da tarefa.
      1. (Opcional) Para Horário de início, selecione o ícone de calendário para especificar a data e a hora de início desta programação de tarefa. Se você não especificar um horário de início, essa programação da tarefa entrará imediatamente em vigor e as execuções são acionadas quando são atendidas as condições especificadas na programação associada.
      2. Para Horário de término, selecione o ícone de calendário para especificar uma data e uma hora de término.

        A data e a hora finais especificadas não podem estar no passado.

        A data final padrão é três meses a partir da data de criação atual desta programação de tarefa. Se você não informar uma data e hora finais específicas, as execuções de tarefas programadas não serão executadas além da data final padrão.

      3. (Opcional) Para Tempo esperado para conclusão, digite um valor e selecione uma unidade no menu para especificar o tempo que leva para uma execução terminar. Você pode especificar um valor em segundos, minutos, horas ou dias.

        Quando uma execução de tarefa excede esse tempo esperado, o Data Integration gera um evento de notificação sem interromper a execução. A tarefa continua a ser executada até que a execução termine ou falhe.

      4. Para Número de repetições, digite o número de repetições da execução da tarefa quando uma execução falhar.
      5. Selecione Configurar.
    10. (Opcional) Se uma tarefa usar parâmetros, você poderá executar as seguintes ações na página Criar programação de tarefa:
      1. Na seção Configurar parâmetros, selecione Configurar para exibir ou alterar os valores padrão de parâmetro a serem utilizados em runtime.
      2. Na página Configurar Parâmetros, selecione Editar ao lado de um valor de parâmetro que você deseja alterar.

        Considere as seguintes restrições:

        • Para propriedades de execução parametrizadas em tarefas configuradas para execução no serviço OCI Data Flow, use o seguinte formato se estiver editando os valores de parâmetro padrão para OCI_DF_LOG_BUCKET e OCI_DF_ARTIFACT_BUCKET: oci://<bucket-name>@<tenancy-name>

        • Se a estratégia de extração incremental de uma origem BICC estiver configurada para usar uma data gerenciada pelo parâmetro do sistema Data Integration SYS.LAST_LOAD_DATE, você não terá permissão para alterar o valor da data durante o design time.

        • Se a estratégia de extração incremental de uma origem BICC estiver configurada para usar uma data de extração mais recente parametrizada adicionada, você poderá alterar o valor da data durante o design time e o runtime.

        • Se uma entidade de dados de destino parametrizada estiver configurada para usar a estratégia Mesclar, você poderá alterar a seleção de chave Mesclar.

      3. No painel Editar parâmetro, altere o valor e selecione Salvar.
      4. Repita as etapas anteriores para alterar outros valores de parâmetro.
      5. Quando terminar, selecione Configurar para retornar à página Criar programação de tarefa.
    11. (Opcional) Na página Criar programação de tarefa, na seção Validar, selecione Validar para verificar erros nos valores de parâmetro configurados.
    12. Selecione Criar e fechar.

      Quando a programação de tarefa é criada com sucesso, o Data Integration exibe uma mensagem de notificação com um link Exibir detalhes. Se você selecionar o link, a página de detalhes da nova programação de tarefa será aberta.

    A programação de tarefa criada é listada na seção Programações de tarefa da página de detalhes do aplicativo. Consulte Listando Programações de Tarefas.

    Todas as programações de tarefas criadas para essa tarefa são listadas na seção Programações de tarefas da página de detalhes da tarefa no aplicativo. Consulte Exibindo Programações de Tarefas Associadas a uma Tarefa.

  • Use o comando oci data-integration task-schedule create e os parâmetros necessários para criar uma programação de tarefa para uma tarefa publicada:

    oci data-integration task-schedule create [OPTIONS]

    Para obter uma lista completa de flags e opções de variáveis para comandos da CLI, consulte a Referência de Linha de Comando.

  • Execute a operação CreateTaskSchedule para criar uma programação de tarefa para uma tarefa publicada.