Share via

Usar o depurador interativo do Databricks

  • 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

Seu notebook deve ser anexado a um cluster que atenda aos seguintes requisitos:

  • Databricks Runtime versão 13.3 LTS ou posterior.
  • O modo de acesso deve ser Usuário Individual (Atribuído) ou Nenhum isolamento compartilhado.

Habilitar ou desabilitar o depurador

Para habilitar ou desabilitar o depurador, faça o seguinte:

  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 o depurador

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. Realize um dos seguintes procedimentos:

    • Clique em Executar > Depuração célula.
    • Use as teclas de atalho 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.

Usar o depurador

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].

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.

Limitações

  • O depurador funciona apenas com Python. Ele não dá suporte a Scala ou R.
  • O depurador não funciona em clusters no modo de acesso Compartilhado.
  • O depurador não dá suporte à entrada em arquivos ou módulos externos.
  • Quando uma sessão de depuração está ativa, você não pode executar outros comandos no notebook.