Agendar uma tarefa de notebook

Você pode criar tarefas para agendar a execução automatizada de um notebook. Cada vez que o notebook é executado de acordo com o horário que você configurou, o site abre um novo contêiner e executa o notebook sem que você precise abrir o notebook. No máximo cinco tarefas podem ser executadas ao mesmo tempo em todos os notebooks de sua propriedade.

A partir do painel Tarefas no editor do notebook, você pode criar uma ou múltiplas tarefas agendadas para executar o notebook. Você pode agendá-lo para ser executado uma vez no futuro ou de forma recorrente—de uma vez a cada 15 minutos a uma vez a cada 6 meses.

Se você estiver preparando um notebook para execução automatizada, como de forma recorrente, há algumas coisas a serem lembradas.

Prepare o notebook

Você pode configurar parâmetros de entrada e saída para um notebook. Os parâmetros de entrada correspondem a variáveis ​​de entrada em um notebook que você deseja externalizar para uma tarefa agendada. Quando uma tarefa agendada é executada, os parâmetros de entrada são inseridos no notebook na parte superior do notebook, semelhantes às variáveis ​​globais. Isso permite criar notebooks genéricos e modificar os valores das variáveis ​​de entrada em tempo de execução.

Os parâmetros da tarefa são injetados por padrão em uma célula no início de um notebook. Como alternativa, você pode usar a opção de célula Tags na barra de ferramentas, que permite criar e gerenciar tags para cada célula na área de trabalho do notebook, para criar uma tag para uma célula denominada injected-parameters. Os parâmetros da tarefa são injetados na célula que segue a tag injected-parameters. Para habilitar tags, você pode alterar as opções da barra de ferramentas da célula clicando em Visualização, clicando em Barra de ferramentas da célula e clicando em Tags.

Considerações para conteúdo

Diferente da célula de parâmetros que ela pode inserir, o agendamento de um notebook não suporta qualquer interação de usuário com notebooks. Evite adicionar qualquer conteúdo que exija interação do usuário enquanto o notebook é executado, como clicar em um ponto do mapa.

Quaisquer credenciais ou novas variáveis que você deseja adicionar no momento da execução automatizada devem ser inseridas na célula de parâmetros, conforme mostrado acima. Verifique se o notebook não contém nenhum conteúdo que o impedirá de concluir.

Anotação:

Ao criar notebooks, use caminhos completos para diretórios e arquivos no diretório da área de trabalho.

Por exemplo, use /arcgis/home/test.gdb em vez de home/test.gdb.

Criar uma tarefa

Quando o notebook estiver pronto, você poderá criar uma tarefa para agendar sua execução. Com a utilização do painel Tarefas no editor do notebook, você pode criar uma ou múltiplas tarefas para automatizar a execução do notebook e especificar o horário da tarefa.

  1. Verifique se você está registrado com privilégios para criar e agendar notebooks.
  2. Salve o notebook com um título, se você ainda não tiver feito isto.

    O botão Tarefas torna-se disponível na barra de formatação superior do editor do notebook.

  3. Na barra de formatação superior do editor de notebook, clique em Tarefas.
  4. Clique em Criar Tarefa para abrir a caixa de diálogo.

    Anotação:
    Você também pode criar tarefas a partir da guia Tarefas da página de detalhes do item do notebook.

  5. Forneça um título na caixa de texto Título para descrever o horário da tarefa, como Execução da limpeza de dados semanal.
  6. Se você não configurou parâmetros anteriormente para o notebook e há parâmetros que deseja adicionar ao notebook quando ele for executado pela tarefa, forneça-os na seção Parâmetros. Forneça uma chave na configuração Chave e seu valor emparelhado na configuração Valor para cada parâmetro, e clique em Adicionar Parâmetro para salvar o parâmetro.

    Após você adicionar pelo menos um parâmetro, a opção Salvar Parâmetros do Notebook aparece. Se esta opção estiver ativada, a célula inserida com seu novo parâmetro será salva no notebook quando for executada.

    Se você configurou parâmetros de entrada anteriormente usando a opção Parâmetros, esses parâmetros serão preenchidos automaticamente para a tarefa. Você pode adicionar, remover ou atualizar quaisquer parâmetros específicos para esta tarefa. Isso não alterará os parâmetros padrão do notebook configurado usando a opção de parâmetros.

  7. Clique em Avançar.
  8. Na página Definir detalhes do agendamento de tarefas, especifique o horário da tarefa.

    Dica:
    Quando você muda o valor de Repetir Tipo, as opções abaixo mudam para ajustar a esta denominação. Por exemplo, se você escolher Semana, as caixas de seleção aparecerão para cada dia da semana.

  9. Use o botão Atualizar Noteboook na Conclusão para optar por salvar o notebook após cada ação executada. Se você deseja atualizar o notebook com os resultados de cada execução, ative o botão de alternância. Se você não desejar que o notebook seja atualizado automaticamente, desative o botão de alternância.
  10. Opcionalmente, clique em Avançado para inserir a quantidade máxima de minutos que a tarefa pode ser executada.
  11. Quando você estiver satisfeito com seu título, parâmetros opcionais e horário da tarefa, clique em Criar Tarefa.

    A tarefa fica ativa e executa o notebook de acordo com o horário que você definiu.

Se deseja ter vários agendamentos, você poderá criar mais tarefas para o notebook usando o mesmo fluxo de trabalho. No máximo cinco tarefas podem ser executadas ao mesmo tempo em todos os notebooks de sua propriedade. As tarefas programadas para iniciar enquanto houver cinco tarefas em andamento são marcadas como com falha.

Trabalhar com tarefas existentes

Após você criar uma tarefa para um notebook, você poderá visualizar os detalhes da tarefa e editar ou exclui-la à qualquer momento. Você pode realizar alterações em tarefas no painel Tarefas do editor de notebook ou a partir da guia Tarefas da página de detalhes do item do notebook. Em ambos os locais, você pode visualizar todas as tarefas do notebook com a hora em que cada tarefa foi criada, quando foi modificada pela última vez e seu status atual.

  1. Verifique se você está registrado com privilégios para criar notebooks.
  2. Na barra de formatação superior do editor de notebook, clique em Tarefas.
  3. Na seção Tarefas Agendadas, encontre a tarefa com a qual deseja trabalhar.
  4. Clique em Ações Ações ao lado da tarefa e faça o seguinte:
    • Clique em Detalhes para visualizar os detalhes e o status de cada execução da tarefa. Para visualizar os resultados da execução, clique no botãoResultados . O status de uma tarefa pode ser um dos seguintes:
      • Bem sucedida—A tarefa foi concluída com sucesso.
      • Executando—A tarefa está executando atualmente.
      • Falhou—A tarefa falhou em executar com sucesso. Se uma tarefa falhar cinco vezes, será completamente parada.
      • Ignorada—A tarefa foi ignorada, pois uma execução anterior ainda estava em execução.
    • Clique em Editar para alterar o título, parâmetros ou horário da tarefa.
    • Clique em Pausar para pausar uma tarefa ativa. Quando pausada, clique em Retomar para retomar a tarefa.
    • Clique em Excluir para remover a tarefa.
      Anotação:

      A exclusão de uma tarefa também exclui o histórico de execução da tarefa. Para preservar o histórico de uma tarefa ativa, considere pausar a tarefa para interromper outras execuções.

Alterar a propriedade de um notebook também altera a propriedade das tarefas desse notebook. As tarefas são transferidas para o novo usuário em um estado inativo. O novo proprietário pode ativar as tarefas no painel Tarefas do editor de notebook ou a partir da guia Tarefas da página de detalhes do item do notebook.