Criando e gerenciando cadernos

Saiba como adicionar cadernos ao seu projeto e gerenciar os cadernos criados.

Permissões necessárias: Você precisa ter a função de Administrador ou Editor no projeto para criar um caderno.

Assista a este breve vídeo para aprender o básico sobre os notebooks do Jupyter.

Este vídeo fornece um método visual para aprender os conceitos e tarefas nesta documentação.

Criando um arquivo de bloco de notas no editor de bloco de notas

Para criar um arquivo de bloco de notas no editor de bloco de notas:

No seu projeto, vá para o Ativos página, Novo ativo > Trabalhar com dados e modelos em Python ou cadernos R.
Na página Novo bloco de notas, especifique o método a ser usado para criar o seu bloco de notas. Você pode criar um notebook em branco, carregar um arquivo de notebook do seu sistema de arquivos ou carregar um arquivo de notebook de um site URL :
- O arquivo de bloco de notas selecionado para upload deve seguir estes requisitos:
  - O tipo de arquivo deve ser .ipynb.
  - O nome do arquivo não deve exceder 255 caracteres.
  - O nome do arquivo não deve conter estes caracteres: < > : ” / | ( ) ?
- O URL deve ser um URL público, acessível a todos e que não exija autenticação.
Especifique o ambiente de tempo de execução para a linguagem que deseja usar (Python ou R). É possível selecionar um modelo de ambiente fornecido ou um modelo de ambiente criado e configurado. Para obter mais informações sobre ambientes, consulte Ambientes de Bloco de Notas
Opcional: Se você tiver pastas ativadas no projeto, selecione uma pasta à qual adicionar o notebook. Para obter mais informações sobre pastas, consulte Organização de ativos com pastas.
Clique em Criar. O bloco de notas é aberto no modo de edição.

O tempo necessário para criar um novo bloco de notas ou abrir um bloco de notas existente para edição pode variar. Se nenhum contêiner de tempo de execução estiver disponível, um contêiner deverá ser criado e somente após ele estar disponível, a interface com o usuário do bloco de notas Jupyter poderá ser carregada. O tempo necessário para criar um contêiner depende da carga e do tamanho do cluster. Quando um contêiner de tempo de execução existe, as chamadas subsequentes para abrir blocos de notas são significativamente mais rápidas.

O bloco de notas aberto é bloqueado por você Para obter mais informações, consulte Bloquear e desbloquear blocos de notas.
Diga ao serviço para confiar em seu conteúdo de bloco de notas e executar todas as células

Quando um novo bloco de notas é aberto no modo de edição, ele é considerado não confiável pelo serviço Jupyter por padrão. Ao executar um bloco de notas não confiável, o conteúdo considerado não confiável não será executado. Conteúdo não confiável inclui qualquer Javascript, HTML ou Javascript em células Markdown ou em qualquer célula de saída que você não gerou.
1. Clique em Não confiável no canto superior direito do bloco de notas.
2. Clique em Confiar para executar todas as células.

Bloqueando e desbloqueando blocos de notas

Se você abrir um bloco de notas no modo de edição, ele será bloqueado por você. Enquanto você mantiver o bloqueio, somente você poderá fazer alterações no caderno. Os usuários de todos os outros projetos verão o ícone de cadeado no bloco de notas. Somente os administradores do projeto podem desbloquear um caderno bloqueado e abri-lo no modo de edição.

Quando você fecha o caderno, o bloqueio é desativado e outro usuário pode optar por abrir o caderno no modo de edição. Observe que é necessário fechar o notebook enquanto o ambiente de execução ainda estiver ativo. O bloqueio do notebook não poderá ser desativado se o ambiente de execução tiver sido interrompido ou estiver inativo. Se o bloqueio do caderno não for desativado para você, é possível desbloqueá-lo na página “Recursos” do projeto. Bloquear o arquivo evita possíveis conflitos de mesclagem que poderiam ser causados por alterações simultâneas no arquivo.

Localizando seus blocos de notas

É possível localizar e abrir blocos de notas na página Ativos do projeto.

É possível abrir um bloco de notas no modo de visualização ou de edição Quando você abre um bloco de notas no modo de visualização, não é possível mudar ou executar o bloco de notas É possível alterar ou executar um bloco de notas somente quando ele for aberto no modo de edição e iniciado em um ambiente

É possível abrir um bloco de notas:

Clicando no bloco de notas Isso abre o bloco de notas no modo de visualização Para abrir o caderno no modo de edição, clique em Editar na barra de ferramentas do caderno. Isso inicia o ambiente associado ao bloco de notas.
Expandindo os três pontos verticais à direita da entrada do bloco de notas e selecionando Visualizar ou Editar

Visualizando informações sobre um bloco de notas

É possível visualizar as seguintes informações sobre um bloco de notas clicando no tipo de ativo Blocos de Notas na página Ativos de seu projeto:

O nome do caderno
A data quando o bloco de notas foi modificado pela última vez e a pessoa que fez a mudança
A linguagem de programação do notebook
Se o bloco de notas está atualmente bloqueado

Próxima etapa

Codificar e executar blocos de notas

Saiba mais

Consulte a seção “Exemplos de cadernos” para ver outros exemplos de cadernos.