Usar o depurador interativo da Databricks
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 ou desativar o depurador
Para ativar ou desativar o depurador, faça o seguinte:
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 o depurador
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.
Siga um destes procedimentos:
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.
Usar o depurador
![barra de ferramentas do depurador da anotar](../_images/debugger-toolbar.png)
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]
.
Use o 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](../_images/debug-console.gif)
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.
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.
Limitações
Consulte Limitações conhecidas Databricks Notebook para obter mais informações.