Depurar código usando o Databricks Connect para a extensão de IDE do Databricks

Este artigo descreve como usar a integração do Databricks Connect na extensão de IDE do Databricks para executar e depurar arquivos Python (.py) individuais. Para obter informações sobre a extensão, consulte extensão de IDE do Databricks.

A integração do Databricks Connect também permite que você execute e depure células de notebook. Consulte Executar e depurar células de notebook com o Databricks Connect usando a extensão de IDE do Databricks.

Requisitos

Antes de poder usar o Databricks Connect a partir da extensão de IDE do Databricks, você deve primeiro atender aos requisitos do Databricks Connect. Esses requisitos incluem itens como um workspace habilitado para o Unity Catalog e requisitos de compute. Ao configurar seu ambiente Python usando a extensão, a versão correta do Python é instalada para você. Consulte Configurar seu ambiente Python e o Databricks Connect.

Configure seu ambiente Python e instale o Databricks Connect

Você pode usar a extensão para configurar facilmente um ambiente Python local que corresponda ao seu compute de destino. Ele cria um .venv local (gerenciado por uv) cuja versão do Python e conjunto de pacotes correspondem à versão do runtime ou serverless, e instala uma versão compatível do Databricks Connect como parte da configuração.

Na visualização Configuração da extensão, clique em Configurar ambiente Python e selecione o compute. Para obter detalhes, incluindo a alternativa da CLI do Databricks, consulte Configurar seu ambiente Python e o Databricks Connect.

Após a instalação do Databricks Connect, se o botão vermelho Databricks Connect disabled aparecer na barra de status do Visual Studio Code, clique nele e siga as instruções na tela para habilitá-lo. Quando o botão Databricks Connect enabled aparecer, você estará pronto para usar o Databricks Connect.

nota

Se você usar o Poetry, poderá sincronizar seus arquivos pyproject.toml e poetry.lock com o pacote Databricks Connect instalado (e suas dependências) executando o seguinte comando. Certifique-se de substituir 16.4.1 pela versão do pacote Databricks Connect que corresponde àquela instalada pela extensão do Databricks IDE para seu projeto.

Bash

poetry add databricks-connect==16.4.1

executar ou depurar seu código Python

Depois de ativar o Databricks Connect, execute ou depure o arquivo Python (.py):

1. Em seu projeto, abra o arquivo Python que o senhor deseja executar ou depurar.

2. Defina quaisquer pontos de interrupção de depuração no arquivo Python.

3. Clique no ícone executar em Databricks ao lado da lista da guia do editor e, em seguida, clique em Debug current file with Databricks Connect .

   

   A saída aparece no painel Debug Console .

   O senhor também pode clicar com o botão direito do mouse no arquivo .py e, em seguida, clicar em executar em Databricks > Debug current file with Databricks Connect .