Extensão do IDE Databricks

A extensão IDE Databricks permite que você conecte seus espaços de trabalho remotos do Azure Databricks a partir do Visual Studio Code ou Cursor na sua máquina local de desenvolvimento. Em seguida, você pode:

• Defina, implante e execute pacotes de automação declarativa para aplicar padrões de CI/CD e práticas recomendadas aos seus Jobs do Lakeflow, pipelines do Lakeflow e stacks de MLOps usando a interface do Visual Studio Code. Veja O que são Pacotes de Automação Declarativa? e recursos de Bundle e explorer.
• Execute arquivos de código de Python locais de Visual Studio Code em clusters Azure Databricks ou computação sem servidor em seus workspaces remotos. Consulte Executar um arquivo Python em um cluster.
• Execute arquivos de código de Python locais (.py) e notebooks de Python, R, Scala e SQL (.py, .ipynb, .r, .scala e .sql) a partir do Visual Studio Code como Lakeflow Jobs em seus espaços de trabalho remotos. Consulte Executar um arquivo Python como um trabalho.
• Instale e configure seu ambiente de depuração e o Databricks Connect usando uma lista de verificação simples que dispara caixas de diálogo de seleção. Veja Debug code usando Databricks Connect para a extensão do IDE Databricks.
• Depurar notebooks célula por célula no Visual Studio Code com o Databricks Connect. Veja : Executar e depurar células de notebooks com Databricks. Conecte usando a extensão do IDE Databricks.
• Sincronize o código local que você desenvolve em Visual Studio Code com o código em seus workspaces remotos. Confira Sincronizar sua pasta de workspace com o Databricks

Introdução

Para começar a usar a extensão do IDE Databricks:

• Instalar a extensão.
• Create um novo projeto do Databricks ou convert um projeto de Visual Studio Code existente.
• Configure seu projeto facilmente usando a UI da extensão do Databricks.
• Execute algum código Python como parte do tutorial extension.
• Depure seu código usando a integração do Databricks Connect.
• Teste seu código usando pytest. Veja Executar testes em Python usando a extensão do IDE Databricks.

Criar um novo projeto do Databricks

Uma vez instalada a extensão, você pode criar um novo projeto Databricks usando a extensão do IDE Databricks:

1. Abra o Visual Studio Code.
2. Clique no ícone Databricks na barra lateral Visual Studio Code para abrir a extensão.
3. Clique em Criar um novo projeto.
4. Na Paleta de comandos, selecione um host e um método de autenticação para o projeto. Veja Configurar autorização para a extensão do IDE Databricks.
5. Em Fornecer um caminho para uma pasta onde você deseja que seu novo projeto esteja, insira o caminho para uma pasta no computador de desenvolvimento local onde você deseja criar o projeto ou clique em Abrir caixa de diálogo de seleção de pasta e selecione o caminho para a pasta do projeto.
6. Para Modelo a ser usado, na exibição de inicialização do projeto do Databricks, use as setas para cima e para baixo para selecionar um modelo de projeto e pressione Enter. Para obter informações sobre modelos de projeto de pacote, consulte modelos de projeto de Pacotes de Automação Declarativa.
7. Digite um Nome exclusivo para este projeto ou deixe o nome do projeto padrão de my_project e pressione Enter.
8. Escolha se deseja adicionar um notebook stub (exemplo), um stub (exemplo) de fluxo de trabalho de Tabelas Dinâmicas Delta ou um pacote Python de stub (exemplo) ao projeto, ou de uma combinação destes stubs (exemplos).
9. Pressione qualquer tecla para fechar a guia editor Databricks Project Init.
10. Para Selecione o projeto que deseja abrir, escolha o projeto que você acabou de criar.

Abrir um projeto de Pacotes de Automação Declarativa existente

Um projeto de Pacotes de Automação Declarativa tem um databricks.yml arquivo na pasta raiz do projeto. Consulte a configuração de Pacotes de Automação Declarativa. Se você quiser usar a extensão com um projeto de Pacotes de Automação Declarativa existente:

1. Abra o Visual Studio Code. No menu principal, clique em Arquivo>Abrir Pasta e navegue até o diretório que contém seu projeto de pacote.

2. Clique no ícone Databricks na barra lateral Visual Studio Code para abrir e começar a usar os recursos da extensão.

   Se a extensão do IDE Databricks descobrir mais de um projeto Declarative Automation Bundles na pasta atual, ela permite que você escolha abrir um projeto ou criar um arquivo de configuração de projeto na pasta raiz.

   

   • Se você escolheu um projeto, na Paleta de Comandos, selecione seu projeto de Pacotes de Automação Declarativa existente.
   • Se você criar uma configuração na pasta raiz, essa pasta se tornará um projeto de pacote.

3. Selecione um host e um método de autenticação para o projeto. Veja Configurar autorização para a extensão do IDE Databricks.

Alternar entre projetos do Databricks

A extensão do IDE Databricks permite que você tenha vários projetos Databricks dentro do seu espaço de trabalho do Visual Studio Code e alterne facilmente entre eles. Com o seu projeto de vários pacotes aberto no workspace do Visual Studio Code:

1. Clique no ícone Databricks na barra lateral Visual Studio Code para abrir a extensão.

2. Clique em Pasta Local para selecionar o projeto a ser utilizado pela extensão.

   

Converter um projeto em um projeto do Databricks

Se você tiver um projeto existente que deseja converter em um projeto do Databricks:

1. Abra o Visual Studio Code. No menu principal, clique em Arquivo>Abrir pasta e navegue até o projeto para abri-lo.
2. Clique no ícone Databricks na barra lateral Visual Studio Code para abrir a extensão.
3. Clique em Criar configuração.
4. Na Paleta de comandos, selecione um host e um método de autenticação para o projeto. Veja Configurar autorização para a extensão do IDE Databricks.