Criar um trabalho de caderno no Studio

nota

O agendador de notebooks é criado a partir dos serviços Amazon EventBridge, SageMaker Training e Pipelines. Se os trabalhos do seu caderno falharem, você poderá ver erros relacionados a esses serviços. A seguir, são apresentadas informações sobre como criar um trabalho de caderno na interface de usuário do Studio.

SageMaker O Notebook Jobs fornece as ferramentas para criar e gerenciar seus trabalhos de notebook não interativos usando o widget Notebook Jobs. Você pode criar trabalhos, visualizar os trabalhos que você criou e pausar, parar ou retomar trabalhos existentes. Você também pode modificar as programações do caderno.

Quando você cria seu trabalho de caderno programado com o widget, o programador tenta inferir uma seleção de opções padrão e preenche automaticamente o formulário para ajudar você a começar rapidamente. Se você estiver usando o Studio, no mínimo poderá enviar um trabalho sob demanda sem definir nenhuma opção. Você também pode enviar uma definição de trabalho de caderno (programada) fornecendo apenas as informações de programação específicas do horário. No entanto, você pode personalizar outros campos se seu trabalho programado exigir configurações especializadas. Se você estiver executando um caderno Jupyter local, a extensão do agendador fornece um atributo para você especificar seus próprios padrões (para um subconjunto de opções) para que você não precise inserir manualmente os mesmos valores todas as vezes.

Ao criar um trabalho no caderno, você pode incluir arquivos adicionais, como conjuntos de dados, imagens e scripts locais. Para fazer isso, escolha Executar trabalho com pasta de entrada. O Notebook Job agora terá acesso a todos os arquivos na pasta do arquivo de entrada. Enquanto o trabalho do caderno está em execução, a estrutura de arquivos do diretório permanece inalterada.

Para executar o caderno em uma programação fixa, conclua as seguintes etapas:

1. Abra o formulário Criar trabalho.

   Em JupyterLab ambientes locais, escolha o ícone Criar um trabalho no notebook ( ) na barra de tarefas. Se você não vir o ícone, siga as instruções para instalar em Guia de instalação.

   No Studio, abra o formulário de duas formas:

   • Usando o Navegador de Arquivos

     1. No Navegador de arquivos no painel esquerdo, clique com o botão direito do mouse no caderno que você deseja executar como um trabalho programado.

     2. Selecione Criar trabalho de caderno.

   • Com o caderno do Studio

     • Dentro do caderno do Studio que você deseja executar como um trabalho programado, escolha o ícone Criar um trabalho do caderno ( ) na barra de ferramentas do Studio.

2. Preencha o formulário popup. O formulário exibe os seguintes campos:

   • Nome do trabalho: um nome descritivo que você especifica para seu trabalho.

   • Arquivo de entrada: o nome do caderno que você está programando para ser executado no modo não interativo.

   • Tipo de computação: o tipo de EC2 instância da Amazon na qual você deseja executar seu notebook.

   • Parâmetros: parâmetros personalizados que você pode especificar opcionalmente como entradas para seu caderno. Para usar esse atributo, você pode, opcionalmente, marcar uma célula específica em seu caderno Jupyter com a tag parameters para controlar onde os parâmetros são aplicados. Consulte mais detalhes em Parametrize seu caderno.

   • (Opcional) Executar trabalho com pasta de entrada: se selecionada, o trabalho agendado terá acesso a todos os arquivos encontrados na mesma pasta do arquivo de entrada.

   • Opções adicionais: você pode especificar personalizações adicionais para seu trabalho. Por exemplo, você pode especificar uma imagem ou kernel, pastas de entrada e saída, opções de repetição e tempo limite de trabalho, detalhes de criptografia e scripts de inicialização personalizados. Para ver a lista completa das personalizações que você pode aplicar, consulte Opções disponíveis.

3. Programe seu trabalho. Você pode executar seu caderno sob demanda ou em uma programação fixa.

   • Para executar o caderno sob demanda, conclua as seguintes etapas:

     • Selecione Executar agora.

     • Escolha Criar.

     • A guia Notebook Jobs é exibida. Escolha Recarregar para carregar seu trabalho no painel.

   • Para executar o caderno em uma programação fixa, conclua as seguintes etapas:

     • Escolha Executar de acordo com uma programação.

     • Escolha a lista suspensa Intervalo e selecione um intervalo. Os intervalos variam de cada minuto a mensalmente. Também é possível selecionar Programação personalizada.

     • Com base no intervalo escolhido, campos adicionais aparecem para ajudá-lo a especificar melhor o dia e a hora de execução desejados. Por exemplo, se você selecionar Dia para uma corrida diária, um campo adicional será exibido para você especificar o horário desejado. Observe que qualquer momento especificado está no formato UTC. Observe também que, se você escolher um intervalo pequeno, como um minuto, seus trabalhos se sobreporão se o trabalho anterior não for concluído quando o próximo trabalho for iniciado.

       Se você selecionar uma programação personalizada, use a sintaxe cron na caixa de expressão para especificar a data e a hora exatas da execução. A sintaxe cron é uma lista de dígitos separados por espaços, cada um representando uma unidade de tempo de segundos a anos. Para obter ajuda com a sintaxe cron, você pode escolher Obter ajuda com a sintaxe cron na caixa de expressão.

     • Escolha Criar.

     • A guia Definições de trabalho do caderno é exibida. Escolha Recarregar para carregar sua definição de trabalho no painel.