Código de depuração usando Databricks Connect para a extensão IDE Databricks

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

A integração do Databricks Connect também permite executar e depurar células de cadernos. Veja Executar e depurar células de blocos de notas com o Databricks Connect utilizando a extensão do IDE Databricks.

Requisitos

Antes de poder usar o Databricks Connect a partir da extensão IDE do Databricks, deve primeiro cumprir os requisitos do Databricks Connect. Estes requisitos incluem coisas como um espaço de trabalho com Unity Catalog e requisitos de computação. Quando configuras o teu ambiente Python usando a extensão, a versão correta do Python é instalada para ti. Veja a configuração do seu ambiente Python e do Databricks Connect.

Configura o teu ambiente Python e instala o Databricks Connect

Podes usar a extensão para configurar facilmente um ambiente Python local que corresponda ao teu cálculo alvo. Constrói um local .venv (gerido por uv) cuja versão Python e conjunto de pacotes correspondem à versão de runtime ou serverless, e instala uma versão compatível do Databricks Connect como parte da configuração.

Na vista de Configuração da extensão, clique em Configurar ambiente Python e selecione computar. Para mais detalhes, incluindo a alternativa ao Azure Databricks CLI, veja Configurar o seu ambiente Python e Databricks Connect.

Após a instalação do Databricks Connect, se o botão vermelho desativado do Databricks Connect aparecer na barra de estado do Visual Studio Code, clique nele e complete as instruções no ecrã para o ativar. Quando aparece o botão ativado do Databricks Connect , está pronto para usar o Databricks Connect.

poetry add databricks-connect==16.4.1

Executa ou depura o teu código Python

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

1. No teu projeto, abre o ficheiro Python que quiseres executar ou depurar.

2. Defina quaisquer pontos de interrupção de depuração dentro do ficheiro Python.

3. Clique no ícone Executar no Databricks ao lado da lista de guias do editor e, em seguida, clique em Depurar arquivo atual comDatabricks Connect.

   

   A saída aparece no painel Debug Console .

   Você também pode clicar com o botão direito do mouse no arquivo .py e, em seguida, clicar em Executar Databricks>Depurar arquivo atual com o Databricks Connect.