Criando e gerenciando blocos de notas

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

Permissões necessárias
Deve-se ter a função de Administrador ou Editor no projeto para criar um bloco de notas.

Assista a este vídeo curto para aprender os fundamentos básicos dos blocos de notas do Jupyter.

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

  • Transcrição de vídeo
    Horário Transcrição
    00:00 Este vídeo aborda os conceitos básicos para trabalhar com notebooks ' Jupyter usando o ' watsonx.ai Studio (Watson Studio).
    00h07 Inicie em um projeto e adicione um notebook ao projeto.
    00:12 Basta fornecer um nome e uma descrição e um ambiente de tempo de execução do Python para usar, em seguida, crie o notebook.
    00:22 Vamos primeiro carregar um arquivo, para que você tenha alguns dados para trabalhar.
    00:28 Basta arrastar e soltar um arquivo no painel deslizante "Arquivos".
    00:32 Depois que o arquivo é incluído ao projeto, ele fica disponível para trabalhar neste notebook.
    00:38 Basta clicar em "Inserir em código" e inserir um pandas DataFrame
    00h43 Antes de executar o notebook, é uma melhor prática inserir uma célula na parte superior para descrever o que o notebook faz.
    00:51 Mude o tipo de célula para Markdown para que esta célula não seja tratada como código e, em seguida, inclua a descrição.
    00:59 Agora, você está pronto para executar o notebook.
    01:02 O código inserido carrega o conjunto de dados em um DataFrame, usando suas credenciais para a sua instância Cloud Object Storage e, em seguida, exibe as primeiras cinco linhas do conjunto de dados.
    01:13 Antes de retornar ao projeto, salve o notebook.
    01:20 Na guia "Ativos", você localizará o notebook.
    01:24 Se você abrir o notebook, ele estará no modo de somente leitura.
    01:28 Mas pode-se editar o notebook e fazer mudanças.
    01:34 Por exemplo, pode-se acessar o painel "Informações" e mudar o nome do notebook.
    01:41 E na guia "Ambiente", pode-se mudar o ambiente usado para executar o notebook, assim como parar ou reiniciar o ambiente de tempo de execução.
    01:53 Se deseja compartilhar uma versão de somente leitura do notebook, pode-se fazer isso a partir daqui.
    01:58 É possível selecionar o quanto do conteúdo que deseja compartilhar e como deseja compartilhar o notebook: seja por meio de um link ou mídias sociais.
    02:08 Se deseja planejar a execução do notebook para um momento diferente, pode-se criar uma tarefa.
    02:14 Basta fornecer um nome para a tarefa e selecionar a versão do notebook e o tempo de execução.
    02:24 Em seguida, selecione as opções de agendamento, como: especificar uma data para a execução da tarefa e se deseja que a execução da tarefa se repita.
    02:43 Depois de criar e executar a tarefa, você verá o status e a tarefa será exibida na guia "Tarefas" no projeto.
    02:55 Encontre mais vídeos na documentação do Cloud Pak for Data as a Service.

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:

  1. No seu projeto, vá para o Ativos página, clique Novo ativo > Trabalhar com dados e modelos em Python ou cadernos R.

  2. Na página Novo notebook, especifique o método a ser usado para criar o seu notebook. Você pode criar um caderno em branco, escolher um caderno de amostra no hub de recursos, carregar um arquivo de caderno do seu sistema de arquivos ou carregar um arquivo de caderno de um site URL :

    • O arquivo de bloco de notas que você seleciona 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: < > : ” / | ( ) ?
    • A URL deve ser uma URL pública que é compartilhável e não requer autenticação.
    • É possível localizar blocos de notas de amostra em Amostras e no hub de Recurso

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

  4. 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 depois que ele estiver disponível, a interface de usuário do notebook Jupyter poderá ser carregada. O tempo que leva 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.

  5. Diga ao serviço para confiar em seu conteúdo de bloco de notas e executar todas as células

    Quando um novo notebook é aberto no modo de edição, o notebook é 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. O 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 não tenha sido gerada por você.

    1. Clique em Não confiável no canto superior direito do bloco de notas.
    2. Clique em Confiança 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ê mantém o bloqueio, só você pode fazer mudanças no notebook. Todos os outros usuários de projetos verão o ícone de bloqueio no notebook. Apenas os administradores do projeto são capazes de desbloquear um notebook bloqueado e abrí-lo no modo de edição.

Ao fechar o notebook, o bloqueio é liberado e outro usuário pode selecionar para abrir o notebook em modo de edição. Note que você deve fechar o notebook enquanto o ambiente de tempo de execução ainda está ativo. O bloqueio do notebook não pode ser liberado para você se o tempo de execução foi interrompido ou estiver em estado inativo. Se o bloqueio do notebook não for liberado para você, pode-se desbloquear o notebook da página de Ativos do projeto. O bloqueio do arquivo evita possíveis conflitos de mesclagem que podem ser causados por mudanças concorrentes 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 mudar 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 notebook no modo de edição, clique em Edit Ícone de edição na barra de ferramentas do notebook. 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 bloco de notas
  • 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 bloco de notas
  • Se o bloco de notas está atualmente bloqueado

Próxima Etapa

Saiba Mais

Localize vídeos mostrando como executar um bloco de notas de amostra a partir do hub de Recursos na Página de Vídeos