O que é a extensão Databricks para Visual Studio Code?

A extensão Databricks para Visual Studio Code permite que você se conecte aos espaços de trabalho remotos do Azure Databricks a partir do Visual Studio Code ou Cursor em sua máquina de desenvolvimento local. Pode então:

• Defina, implemente e execute Pacotes de Automação Declarativa para aplicar padrões e melhores práticas de CI/CD aos seus Jobs de Lakeflow, Pipelines Declarativos de Lakeflow Spark e Stacks MLOps, usando a UI do Visual Studio Code. Veja O que são os Pacotes de Automação Declarativa? e as funcionalidades de extensão dos Pacotes de Automação Declarativa.
• Execute arquivos de código Python locais do Visual Studio Code em clusters do Azure Databricks ou computação sem servidor em seus espaços de trabalho remotos. Consulte Executar um arquivo Python em um cluster.
• Execute arquivos de código Python locais (.py) e blocos de anotações Python, R, Scala e SQL (.py, .ipynb, .r, .scalae .sql) do Visual Studio Code como Lakeflow Jobs em seus espaços de trabalho remotos. Consulte Executar um arquivo Python como um trabalho.
• Configure seu ambiente de depuração e o Databricks Connect usando uma lista de verificação simples que aciona caixas de diálogo de seleção. Consulte Depurar código usando Databricks Connect da extensão Databricks do Visual Studio Code.
• Depurar blocos de anotações célula a célula dentro do Visual Studio Code com Databricks Connect. Consulte Executar e depurar células de blocos de notas com o Databricks Connect usando a extensão Databricks para Visual Studio Code.
• Sincronize o código local que você desenvolve no Visual Studio Code com o código em seus espaços de trabalho remotos. Consulte Sincronizar a pasta do seu espaço de trabalho com o Databricks

Nota

A extensão Databricks para Visual Studio Code oferece suporte à execução de blocos de anotações R, Scala e SQL como trabalhos automatizados, mas não fornece suporte mais profundo para essas linguagens no Visual Studio Code.

Introdução

Para começar a usar a extensão Databricks para Visual Studio Code:

• Instale a extensão.
• Criar um novo projeto Databricks ou converter um projeto existente do Visual Studio Code.
• Configure seu projeto facilmente usando a interface do usuário da extensão Databricks.
• Execute algum código Python como parte do tutorial de extensão.
• Depure seu código usando a integração do Databricks Connect.
• Teste o seu código usando pytest. Consulte Executar testes Python usando a extensão Databricks para Visual Studio Code.

Criar um novo projeto Databricks

Depois que a extensão for instalada, você poderá criar um novo projeto Databricks usando a extensão Databricks para Visual Studio Code:

1. Abra o Visual Studio Code.
2. Clique no ícone Databricks na barra lateral do Visual Studio Code para abrir a extensão.
3. Clique em Criar um projeto novo.
4. Na Paleta de Comandos, selecione um anfitrião e um método de autenticação para o projeto. Consulte Configurar a autorização para a extensão Databricks para Visual Studio Code.
5. Em Forneça um caminho para uma pasta onde gostaria de ter o seu novo projeto, insira o caminho para uma pasta no seu computador de desenvolvimento local onde deseja criar o projeto ou clique em Abrir diálogo de seleção de pasta e selecione o caminho para a pasta do projeto.
6. Para Modelo a ser usado no modo de exibição de inicialização do projeto Databricks, use as setas para cima e para baixo para selecionar um modelo de projeto e pressione Enter. Para informações sobre modelos de projetos em bundles, consulte Templates de projetos Declarative Automation Bundles.
7. Digite um nome exclusivo para este projeto para o projeto ou deixe o nome do projeto padrão de my_projecte, em seguida, pressione Enter.
8. Escolha se deseja adicionar um bloco de notas de exemplo, um pipeline de exemplo do Delta Live Tables, ou um pacote de Python de exemplo ao projeto, ou qualquer combinação destes exemplos.
9. Pressione qualquer tecla para fechar a guia Databricks Project Init do editor.
10. Para Selecione o projeto que deseja abrir, escolha o projeto que você acabou de criar.

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

Um projeto Declarative Automation Bundles tem um databricks.yml ficheiro na pasta raiz do projeto. Ver configuração dos Pacotes de Automação Declarativa. Se quiser usar a extensão com um projeto existente de Declarative Automation Bundles:

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

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

   Se a extensão Databricks para Visual Studio Code detetar mais do que um projeto Declarative Automation Bundles na pasta atual, permite-lhe escolher abrir um projeto ou criar um ficheiro de configuração de projeto na pasta raiz.

   

   • Se escolher um projeto, na Paleta de Comandos, selecione o seu projeto existente de Pacotes de Automação Declarativa.
   • 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. Consulte Configurar a autorização para a extensão Databricks para Visual Studio Code.

Nota

Se você abrir um projeto criado usando a extensão Databricks para Visual Studio Code v1, a migração será tentada automaticamente usando a autenticação existente do projeto e a configuração do espaço de trabalho. O botão de migração só estará disponível se a migração automática falhar.

Alternar entre os projetos do Databricks

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

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

2. Clique em Pasta Local para selecionar o projeto que a extensão deve usar.

   

Nota

As ações de execução só estão disponíveis para arquivos no pacote ativo.

Converter um projeto em um projeto Databricks

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

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