As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Criar um trabalho de caderno no Studio
<a name="create-notebook-auto-run-studio"></a>

**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** (![\[Blue icon of a calendar with a checkmark, representing a scheduled task or event.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/icons/notebook-schedule.png)) na barra de tarefas. Se você não vir o ícone, siga as instruções para instalar em [Guia de instalação](scheduled-notebook-installation.md).

   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.

     1. 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** (![\[Blue icon of a calendar with a checkmark, representing a scheduled task or event.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/icons/notebook-schedule.png)) na barra de ferramentas do Studio.

1. 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 instância do Amazon EC2 na qual você deseja executar seu caderno.
   + **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](notebook-auto-run-troubleshoot-override.md).
   + (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](create-notebook-auto-execution-advanced.md).

1. 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.

# Configurar opções padrão para cadernos locais
<a name="create-notebook-auto-execution-advanced-default"></a>

**Importante**  
Em 30 de novembro de 2023, a experiência anterior do Amazon SageMaker Studio agora se chama Amazon SageMaker Studio Classic. A seção a seguir é específica ao uso da aplicação Studio Classic. Para obter informações sobre como usar a experiência atualizada do Studio, consulte [SageMaker Estúdio Amazon](studio-updated.md).  
O Studio Classic ainda é mantido para cargas de trabalho existentes, mas não está mais disponível para integração. Você só pode parar ou excluir aplicativos do Studio Classic existentes e não pode criar novos. Recomendamos que você [migre sua carga de trabalho para a nova experiência do Studio](studio-updated-migrate.md).

Você pode configurar as opções padrão ao criar um trabalho no caderno. Isso pode economizar seu tempo caso planeje criar vários trabalhos de caderno com opções diferentes dos padrões fornecidos. As informações a seguir mostram como configurar as opções padrão para cadernos locais.

Se você precisar digitar (ou colar) manualmente valores personalizados no formulário **Criar um trabalho**, poderá armazenar novos valores padrão e a extensão do agendador inserirá seus novos valores sempre que você criar uma nova definição de trabalho. Este atributo está disponível nas seguintes opções:
+ **ARN de função**
+ **Pasta de entrada S3**
+ **Pasta de saída do S3**
+ **Chave do KMS de criptografia de saída** (se você ativar o **Configurar criptografia de trabalho**)
+ **Chave do KMS de criptografia de volume da instância de trabalho** (se você ativar o **Configurar criptografia de trabalho**)

Esse atributo economiza tempo se você inserir valores diferentes dos padrões fornecidos e continuar a usar esses valores para futuras execuções de trabalhos. As configurações de usuário escolhidas são armazenadas na máquina que executa seu JupyterLab servidor e são recuperadas com a ajuda da API nativa. Se você fornecer novos valores padrão para uma ou mais opções, mas não para todas as cinco opções, os padrões anteriores serão usados para aquelas que você não personalizou.

As instruções a seguir mostram como pré-visualizar os valores padrão existentes, definir novos valores padrão e redefinir seus valores padrão para seus trabalhos de caderno.

**Para pré-visualizar os valores padrão existentes para os trabalhos do caderno, conclua as seguintes etapas:**

1. Abra o console do Amazon SageMaker Studio Classic seguindo as instruções em[Inicie o Amazon SageMaker Studio Classic](studio-launch.md).

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.

1. Selecione **Criar trabalho de caderno**.

1. Escolha **Opções adicionais** para expandir a guia das configurações de trabalho do caderno. Você pode ver as configurações padrão aqui. 

**Para definir novos valores padrão para seus trabalhos de caderno futuros, conclua as seguintes etapas:**

1. Abra o console do Amazon SageMaker Studio Classic seguindo as instruções em[Inicie o Amazon SageMaker Studio Classic](studio-launch.md).

1. No menu superior do Studio Classic, escolha **Configurações** e, em seguida, escolha **Editor de configurações avançadas**.

1. Escolha **Amazon SageMaker Scheduler** na lista abaixo de **Configurações**. É possível que já esteja aberto por padrão.

1. Você pode atualizar as configurações padrão diretamente da página da interface do usuário ou usando o editor JSON.
   + Na interface de usuário, você pode inserir novos valores para **ARN da função**, **Pasta de entrada do S3**, **Pasta de saída do S3**, **Chave do KMS de criptografia de saída** ou **Chave do KMS de criptografia de volume da instância de trabalho**. Se você alterar esses valores, verá os novos padrões para esses campos ao criar seu próximo trabalho no caderno em **Opções adicionais**.
   + (Opcional) Para atualizar os padrões do usuário usando o **Editor de configurações JSON**, conclua as seguintes etapas:

     1. No canto superior direito, escolha **Editor de configurações JSON**.

     1. Na barra lateral esquerda de **Configurações**, escolha **Amazon SageMaker AI Scheduler**. É possível que já esteja aberto por padrão.

        Você pode ver seus valores padrão atuais no painel **Preferências do usuário**.

        Você pode ver os valores padrão do sistema no painel **Padrões do sistema**.

     1. Para atualizar seus valores padrão, copie e cole o trecho JSON do painel **Padrões do sistema** no painel **Preferências do usuário** e atualize os campos.

     1. Se você atualizou os valores padrão, escolha o ícone **Salvar configurações do usuário** (![\[Icon of a cloud with an arrow pointing upward, representing cloud upload functionality.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/icons/Notebook_save.png)) no canto superior direito. Fechar o editor não salva as alterações.

**Se você alterou anteriormente e agora deseja redefinir os valores padrão definidos pelo usuário, conclua as seguintes etapas:**

1. No menu superior do Studio Classic, escolha **Configurações** e, em seguida, escolha **Editor de configurações avançadas**.

1. Escolha **Amazon SageMaker Scheduler** na lista abaixo de **Configurações**. É possível que já esteja aberto por padrão.

1. Você pode restaurar os padrões usando essa página de interface do usuário diretamente ou usando o editor JSON.
   + Na interface do usuário, você pode escolher **Restaurar padrões** no canto superior direito. Seus padrões são restaurados para strings vazias. Você só verá essa opção se tiver alterado anteriormente seus valores padrão.
   + (Opcional) Para restaurar as configurações padrão usando o **Editor de configurações JSON**, conclua as seguintes etapas:

     1. No canto superior direito, escolha **Editor de configurações JSON**.

     1. Na barra lateral esquerda de **Configurações**, escolha **Amazon SageMaker AI Scheduler**. É possível que já esteja aberto por padrão.

        Você pode ver seus valores padrão atuais no painel **Preferências do usuário**.

        Você pode ver os valores padrão do sistema no painel **Padrões do sistema**.

     1. Para restaurar as configurações padrão atuais, copie o conteúdo do painel **Padrões do sistema** para o painel **Preferências do usuário**.

     1. Escolha o ícone **Salvar configurações do usuário** (![\[Icon of a cloud with an arrow pointing upward, representing cloud upload functionality.\]](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/icons/Notebook_save.png)) no canto superior direito. Fechar o editor não salva as alterações.