Caderno de depuração

Visualização

Esse recurso está em Prévia Pública.

Esta página descreve como usar o depurador interativo integrado no Databricks Notebook. O depurador está disponível apenas para Python.

O depurador interativo oferece pontos de interrupção, execução passo a passo, inspeção de variáveis e outras ferramentas para ajudá-lo a desenvolver códigos no Notebook com mais eficiência.

Requisitos

Para acessar o depurador, o Notebook deve estar conectado a um dos seguintes recursos compute:

  • Compute serverless

  • cluster com modo de acesso definido como Single user em Databricks Runtime 13.3 LTS e acima

  • cluster com modo de acesso definido como No Isolation Shared em Databricks Runtime 13.3 LTS e acima

  • cluster com modo de acesso definido como Compartilhado em Databricks Runtime 14.3 LTS e acima

Ativar o depurador

Use os seguintes passos do sistema operacional para ativar o depurador:

  1. Clique no seu nome de usuário no canto superior direito do site workspace e selecione Settings (Configurações ) na lista dropdown.

  2. Na barra lateral Settings (Configurações ), selecione Developer (Desenvolvedor).

  3. Na seção Recurso experimental, alterne o Depurador interativo do Python Notebook.

começar depuração

Para iniciar o depurador, siga estes passos:

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

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

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

    • Clique em executar > Debug cell.

    • Use o atalho de teclado Option + Shift + D.

    • No menu de execução da célula, selecione Depurar célula.

    item de depuração de célula no menu de execução de célula

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

O senhor 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 Debug.

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

Ações de depuração

barra de ferramentas do depurador da anotar

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

  • Definir ou remover pontos de interrupção.

  • view os valores das variáveis em um ponto de interrupção.

  • o passo a passo no código.

  • o passo para entrar ou sair de uma função.

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

Use os botões da barra de ferramentas do depurador para percorrer o código. À medida que o senhor avança no código, a linha atual é destacada na célula. O senhor pode view valores de variáveis no painel explorador de variáveis na barra lateral direita.

Quando o senhor passa por uma função, as variáveis locais da função aparecem no painel de variáveis, marcadas como [local].

Console de depuração

Quando o senhor inicia uma sessão de depuração, o console de depuração aparece automaticamente no painel inferior. Esse console permite que o senhor execute o código Python para inspecionar ou manipular variáveis quando pausa em um ponto de interrupção. O código executado no site 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 foi projetado para avaliações rápidas e atinge o tempo limite se a execução do código exceder 15 segundos.

  • O comando display não é compatível com o console de depuração. Para view dados de amostra de um DataFrame, use df.show() para PySpark DataFrames ou df.head() para Pandas DataFrames.

Explorador variável

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

exemplo de painel do explorador de variáveis

Para filtrar a exibição, digite o texto na caixa de pesquisa. A lista é filtrada automaticamente à medida que o senhor digita.

Para Python em Databricks Runtime 12.2 LTS e acima, as variáveis são atualizadas como uma execução de célula. Para Scala, R e Python no Databricks Runtime 11.3 LTS e abaixo, as variáveis são atualizadas após o término da execução de uma célula.

Encerrar uma sessão do depurador

Para encerrar a sessão de depuração, clique em botão de parada do depurador no canto superior esquerdo da célula ou clique em Notebook botão de parada na parte superior do site Notebook. A sessão de depuração também é 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 Databricks Assistant

O Databricks Assistant é um assistente de IA com reconhecimento de contexto que pode ajudá-lo a depurar seu código. Para obter mais informações, consulte Use Databricks Assistant in a Notebook cell.

Limitações

Consulte Limitações conhecidas Databricks Notebook para obter mais informações.