Compartilhar via

Depurar notebooks

  • Artigo

Importante

Esse recurso está em uma versão prévia.

Esta página descreve como usar o depurador interativo interno no notebook do Databricks. O depurador está disponível somente para Python.

O depurador interativo fornece pontos de interrupção, execução passo a passo, inspeção de variável e mais ferramentas para ajudar você a desenvolver código em notebooks com mais eficiência.

Requisitos

Para acessar o depurador, seu notebook deve estar conectado a um dos seguintes recursos de computação:

  • Computação sem servidor
  • Cluster com modo de acesso definido como Usuário único no Databricks Runtime 13.3 LTS e superior
  • Cluster com modo de acesso definido como Nenhum Isolamento Compartilhado no Databricks Runtime 13.3 LTS e superior
  • Cluster com o modo de acesso definido como Compartilhado no Databricks Runtime 14.3 LTS e superior

Habilitar o depurador

Use as seguintes etapas para habilitar o recurso:

  1. Clique no nome de usuário na parte superior direita do workspace e selecione Configurações na lista suspensa.
  2. Na barra lateral Configurações, selecione Desenvolvedor.
  3. Na seção Recursos experimentais, alterne para o Depurador Interativo do Notebook Python.

Iniciar a depuração

Para iniciar o depurador, siga estas etapas:

  1. Adicione um ou mais pontos de interrupção clicando na medianiz de uma célula. Para remover um ponto de interrupção, clique nele novamente.

    criar e remover vídeo de pontos de interrupção

  2. Inicie a sessão de depuração usando uma das seguintes opções:

    • Clique em Executar > Depuração célula.
    • Use o atalho de teclado Ctrl + Shift + D.
    • No menu de execução da célula, selecione Depurar célula.

    depurar item de célula no menu de execução da célula

Uma sessão de depuração é iniciada automaticamente e executa a célula selecionada.

Você também pode iniciar o depurador se uma célula disparar um erro. Na parte inferior da saída da célula, clique em Botão Depurar.

Quando uma sessão de depuração está ativa, a barra de ferramentas de depuração Barra de ferramentas de depuração é exibida na parte superior da célula.

Opções de depuração

barra de ferramentas do depurador anotado

Em uma sessão de depuração, você pode fazer o seguinte:

  • Defina ou remova os pontos de interrupção.
  • Exiba os valores das variáveis em um ponto de interrupção.
  • Explore o código.
  • Entre ou saia de uma função.

Quando o código atinge um ponto de interrupção, ele é interrompido antes que a linha seja executada, não depois.

Use os botões na barra de ferramentas do depurador para percorrer o código. Conforme você percorre o código, a linha atual é realçada na célula. Você pode exibir os valores de variáveis no painel do gerenciador de variáveis na barra lateral direita.

Quando você percorre uma função, as variáveis de função local são exibidas no painel de variáveis, marcadas como [local].

Console de depuração

Quando você inicia uma sessão de depuração, o console de depuração é exibido automaticamente no painel inferior. Esse console permite que você execute o código Python para inspecionar ou manipular variáveis quando pausado em um ponto de interrupção. O código executado no notebook principal não é executado durante uma sessão de depuração. Para executar o código no console, pressione Enter. Para expressões de várias linhas, use Shift + Enter para mover para uma nova linha.

debug_console

Observação

  • O console de depuração é projetado para avaliações rápidas e atingirá o tempo limite se a execução do código exceder 15 segundos.
  • Não há suporte para o comando display no console de depuração. Para exibir dados de exemplo de um DataFrame, use df.show() para DataFrames do PySpark ou df.head() para DataFrames do Pandas.

Gerenciador de variáveis

Você pode usar o painel do gerenciador de variáveis ícone do explorador de variável no lado direito para exibir os valores de suas variáveis. Clicar em Inspecionar executa automaticamente o código no console de depuração para gerar o valor da variável.

painel do explorador de variável de exemplo

Para filtrar a exibição, insira o texto na caixa de pesquisa. A lista é filtrada automaticamente conforme você digita.

Para Python no Databricks Runtime 12.2 LTS e superior, as variáveis são atualizadas à medida que uma célula é executada. Para Scala, R e para Python no Databricks Runtime 11.3 LTS e abaixo, as variáveis são atualizadas depois que uma célula termina a execução.

Encerrar uma sessão de depurador

Para encerrar a sessão de depuração, clique em Botão parar do depurador no canto superior esquerdo da célula ou clique em botão parar do notebook na parte superior do notebook. A sessão de depuração também será encerrada automaticamente após 30 minutos se o usuário não usar a barra de ferramentas de depuração ou o console de depuração.

Depurar com o Assistente do Databricks

O Assistente do Databricks é um assistente de IA com reconhecimento de contexto que pode ajudá-lo a depurar seu código. Consulte Usar o Assistente do Databricks em uma célula de notebook para obter mais informações.

Limitações

Consulte Limitações conhecidas dos notebooks do Databricks para obter mais informações.