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
O site Notebook deve ser anexado a um cluster que atenda aos seguintes requisitos:
Databricks Runtime versão 13.3 LTS ou superior.
O modo de acesso deve ser Usuário único (Atribuído) ou Sem isolamento compartilhado.
Ativar o depurador
Use os seguintes passos do sistema operacional para ativar o depurador:
Clique no seu nome de usuário no canto superior direito do site workspace e selecione Settings (Configurações ) na lista dropdown.
Na barra lateral Settings (Configurações ), selecione Developer (Desenvolvedor).
Na seção Recurso experimental, alterne o Depurador interativo do Python Notebook.
começar depuração
Para iniciar o depurador, siga estes passos:
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.
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.
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 .
Quando uma sessão de depuração está ativa, a barra de ferramentas de depuração aparece na parte superior da célula.
Ações de depuração
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.
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, usedf.show()
para PySpark DataFrames oudf.head()
para Pandas DataFrames.
Explorador variável
O senhor pode usar o painel 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.
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 no canto superior esquerdo da célula ou clique em 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.