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:

  1. Clique no seu nome de usuário no canto superior direito do site workspace e selecione User Settings (Configurações do usuário ) 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 o depurador

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. Siga um destes procedimentos:

    • Clique em executar > Debug cell.

    • Use o atalho de teclado Ctrl + 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.

Usar o depurador

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

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 da página Notebook.

Limitações

  • O depurador funciona apenas com o Python. Ele não é compatível com Scala ou R.

  • O depurador não funciona em clusters de modo de acesso compartilhado.

  • O depurador não é compatível com o passo a passo em arquivos ou módulos externos.

  • Quando uma sessão de depuração está ativa, o senhor não pode executar outro comando no site Notebook.