Partes de um bloco de notas

Um notebook é composto por células que contêm código ou informações textuais e vários outros elementos que ajudam você a interagir com o código.

Quando você abre um caderno no modo de visualização, os únicos elementos disponíveis são as células e a barra de ações. Você pode usá-lo para executar, agendar, compartilhar, baixar ou visualizar informações sobre o seu notebook. Para acessar opções adicionais, clique no ícone Editar para entrar no modo de edição.

Ao abrir um caderno no modo de edição, o editor do caderno inclui os seguintes elementos:

Observação: algumas das funcionalidades do notebook só estão disponíveis nas versões mais recentes do runtime. Se você estiver executando seu notebook em um ambiente baseado no Runtime 22.2, alguns recursos, como o depurador ou o índice automático, não estarão disponíveis.

Na barra de menus e na barra de ferramentas principal, você pode selecionar recursos do bloco de notas que afetam o funcionamento do bloco de notas e realizar as operações mais utilizadas nele.

menu e barra de ferramentas

Conteúdo

Você pode navegar pelo caderno usando um Índice gerado automaticamente com base nos títulos do seu caderno. Para visualizar o Índice, no menu Exibir, selecione Índice.

Para adicionar números aos títulos, clique no ícone “Mostrar números dos títulos no documento ”. Para ativar ou desativar a exibição de um número ao lado dos títulos de primeiro nível ( h1 ), por exemplo, quando você quiser que o título de primeiro nível seja exibido como o título do caderno, clique no botão “Mais ações ” e selecione “Mostrar número do título de primeiro nível ”.

Para excluir ou incluir do Índice os títulos gerados como parte da saída das células, clique no botão “Mais ações ” e selecione “Mostrar títulos de saída ”.

Observação: você pode executar células de código diretamente a partir do Índice. Para executar as células de um título, clique com o botão direito do mouse no título e selecione “Selecionar e executar célula(s) deste título”.

Índice adicionado automaticamente

Barra de ação do bloco de notas

Você pode selecionar recursos que melhoram a colaboração em cadernos. Na barra de ação, é possível:

  • Crie um link permanente URL para que qualquer pessoa com o link possa visualizar seu caderno
  • Crie uma tarefa para executar seu notebook ou visualize as tarefas existentes para o notebook. Veja a agenda em um caderno
  • Baixe o notebook para o seu computador como um .ipynb arquivo
  • Visualize as informações do seu notebook e interaja com o ambiente em que ele está sendo executado
  • Salve versões do seu caderno
  • Carregar recursos no projeto

Barra de ação do bloco de notas

Células em um notebook do Jupyter

Um bloco de notas do Jupyter consiste em uma sequência de células. O fluxo de um bloco de notas é sequencial. Você insere código em uma célula de entrada e, ao executar a célula, o bloco de notas executa o código e imprime a saída do cálculo em uma célula de saída.

É possível mudar o código em uma célula de entrada e executar novamente a célula com a frequência que desejar. Dessa forma, o notebook segue o paradigma do ciclo ler-avaliar-imprimir.

Cada célula possui sua própria minibarra de ferramentas.

Barra de ferramentas da célula

Diretamente da barra de ferramentas da célula, você pode:

  • Copie a célula
  • Mova a célula para cima ou para baixo
  • Insira uma nova célula antes e depois de outra célula
  • Apagar a célula

Para recolher uma célula, clique no botão de Ícone de colapso de célula recolhimento que se encontra ao lado de cada célula. Para expandir uma célula, clique no botão de recolhimento ou no ícone Ícone para expandir a célulaExpandir.

O comportamento de uma célula é determinado por um tipo de célula. Os diferentes tipos de células incluem:

Células de código de Jupy

Nas células de código do Jupyter, você pode editar e escrever novos códigos.

células de código

Para exibir os números de linha ao lado do código, no menu Exibir, selecione Mostrar números de linha.

Para visualizar a célula de código e a célula de saída lado a lado, vá até “Exibir” no menu do Editor e clique em “Exibir lado a lado ”.

Células de código lado a lado

Células de markdown do Jupyter

Nas células Markdown do Jupyter, você pode documentar o processo computacional. É possível inserir títulos para estruturar seu bloco de notas hierarquicamente.

Também é possível incluir e editar arquivos de imagem como anexos no bloco de notas. O código de markdown e as imagens são renderizados quando a célula é executada.

células de Markdown

Veja Markdown para folha de dicas de blocos de notas Jupyter.

Células NBConvert de Jupyter Brutos

As células brutas não são avaliadas pelo bloco de notas. Uma célula em bruto é útil se você estiver procurando um local para armazenar conteúdo que não deseja executar, como resultados gerados.

Depurador

O depurador pode ajudá-lo a resolver rapidamente problemas relacionados ao código. Para ativar o depurador:

  1. Clique no ícone “Ativar Ícone para ativar o depurador Depurador” na barra de ferramentas do notebook.
  2. Clique ao lado de qualquer linha de código para adicionar um ponto de interrupção.

Para depurar seu código, no menu Exibir, selecione “Barra lateral direita ” e, em seguida, selecione “Mostrar depurador ”.

Depurador de células de código do Notebook

Barra de progresso da tarefa do Spark

Quando você executa código em um notebook que aciona tarefas do Spark, muitas vezes é difícil determinar por que o código não está sendo executado com eficiência.

Para ajudar você a entender melhor o que seu código está fazendo e auxiliar na depuração do código, um notebook pode monitorar a execução dos trabalhos do Spark para uma célula de código.

Para ativar o monitoramento do Spark para uma célula em um notebook:

  • Selecione a célula de código que você deseja monitorar.
  • Clique no ícone “Ativar monitoramento Ícone para ativar o monitoramento do Spark do Spark” na barra de ferramentas do notebook.

As barras de progresso que você vê mostram o andamento em tempo real da execução de seus trabalhos no cluster do Spark. Cada tarefa do Spark é executada no cluster em uma ou mais etapas, sendo que cada etapa é uma lista de tarefas que podem ser executadas em paralelo. O painel de monitoramento pode ficar muito grande se o trabalho do Spark tiver muitas etapas.

O painel de monitoramento de tarefas também exibe a duração de cada tarefa e o status das etapas da tarefa. Uma etapa pode ter um dos seguintes status:

  • Running: A etapa está ativa e iniciada
  • Completed: A etapa foi concluída
  • Skipped: Os resultados desta etapa foram armazenados em cache a partir de uma operação anterior e, portanto, a tarefa não precisa ser executada novamente
  • Pending: A etapa ainda não começou

Clique no ícone novamente para desativar o monitoramento em uma célula.

Observação: atualmente, o monitoramento do Spark só é compatível com notebooks executados no Python.