Selecione um diretório de espaço de trabalho para a extensão Databricks para Visual Studio Code

Este artigo descreve como selecionar um diretório de espaço de trabalho do Azure Databricks para a extensão Databricks para Visual Studio Code usar. Consulte O que é a extensão Databricks para Visual Studio Code?

As informações a seguir pressupõem que você já tenha configurado a extensão Databricks para Visual Studio Code para autenticação com seu espaço de trabalho Azure Databricks. Consulte Configuração de autenticação para a extensão Databricks para VS Code.

Nota

Se você já concluiu o tutorial da extensão VSCode para Databricks: Executar Python em um cluster e como um trabalho, e deseja continuar usando o diretório de espaço de trabalho desse tutorial, pule para Tarefas de desenvolvimento para a extensão Databricks para Visual Studio Code.

Nota

A extensão Databricks para Visual Studio Code funciona apenas com diretórios de espaço de trabalho que ele cria. Você não pode usar um diretório de espaço de trabalho existente em seu espaço de trabalho, a menos que ele tenha sido criado pela extensão.

Para usar diretórios de espaço de trabalho com a extensão Databricks para Visual Studio Code, você deve usar a versão 0.3.5 ou superior da extensão e seu cluster do Azure Databricks deve ter o Databricks Runtime 11.3 LTS ou superior instalado.

Diretórios de espaço de trabalho é a configuração padrão, começando com a versão 0.3.15 da extensão. No entanto, se você definir a extensão para usar uma pasta Databricks Git em vez de um diretório de espaço de trabalho, poderá definir a extensão de volta para usar diretórios de espaço de trabalho da seguinte maneira:

1. Com a extensão e seu projeto de código abertos, e um perfil de configuração do Azure Databricks já definido, na Paleta de Comandos (Exibir Paleta de Comandos), digite Preferences: Open User Settingse clique em Preferências: Abrir Configurações do Usuário>.
2. Na guia Usuário, expanda Extensões e clique em Databricks.
3. Em Sync: Destination Type, selecione workspace.
4. Feche e reinicie o Visual Studio Code.

Observe que depois de alterar a configuração de usar uma pasta Databricks Git para usar diretórios de espaço de trabalho, talvez seja necessário ressincronizar manualmente o código para o espaço de trabalho. Para fazer isso, depois de criar um novo diretório de espaço de trabalho no próximo procedimento, clique no ícone de círculo de seta (Iniciar sincronização) ao lado de Destino de sincronização.

Com a extensão e seu projeto de código abertos, crie um novo diretório de espaço de trabalho do Azure Databricks que você deseja usar ou selecione um diretório de espaço de trabalho existente que você criou anteriormente com a extensão.

Criar um novo diretório de espaço de trabalho

Para criar um novo diretório de espaço de trabalho, faça o seguinte:

1. No painel Configuração, ao lado de Destino de sincronização, clique no ícone de engrenagem (Configurar destino de sincronização).

   

2. Na Paleta de Comandos, clique em Criar Novo Destino de Sincronização.

3. Digite um nome para o novo diretório de espaço de trabalho e pressione Enter.

   A extensão cria um diretório com o nome de diretório especificado dentro do espaço de trabalho e, em /Users/<your-username>/.ide seguida, adiciona o caminho do diretório do espaço de trabalho ao arquivo do projeto de .databricks/project.json código, por exemplo "workspacePath": "/Users/<your-username>/.ide/<your-directory-name>".

   Nota

   Se o nome do diretório do espaço de trabalho remoto não corresponder ao nome do seu projeto de código local, um ícone de aviso será exibido com esta mensagem: O nome do destino da sincronização remota não corresponde ao nome atual do espaço de trabalho do Visual Studio Code. Você pode ignorar esse aviso se não exigir que os nomes correspondam.

4. Depois de definir o diretório do espaço de trabalho, comece a sincronizar com o diretório do espaço de trabalho clicando no ícone de círculo de seta (Iniciar sincronização) ao lado de Destino da sincronização.

   

Importante

A extensão Databricks para Visual Studio Code executa apenas a sincronização automática unidirecional de alterações de arquivo do seu projeto local do Visual Studio Code para o diretório de espaço de trabalho relacionado em seu espaço de trabalho remoto do Azure Databricks. Os arquivos neste diretório de espaço de trabalho remoto devem ser transitórios. Não inicie alterações nesses arquivos de dentro do seu espaço de trabalho remoto, pois essas alterações não serão sincronizadas de volta ao seu projeto local.

Continue com as tarefas de desenvolvimento para a extensão Databricks para Visual Studio Code.

Reutilizar um diretório de espaço de trabalho existente

Se você tiver um diretório de espaço de trabalho existente que você criou anteriormente com a extensão Databricks para Visual Studio Code e deseja reutilizar em seu projeto atual do Visual Studio Code, faça o seguinte:

1. No painel Configuração, ao lado de Destino de sincronização, clique no ícone de engrenagem (Configurar destino de sincronização).

   

2. Na Paleta de comandos, selecione o nome do diretório do espaço de trabalho na lista.

A extensão adiciona o caminho do diretório do espaço de trabalho ao arquivo do projeto de .databricks/project.json código, por exemplo "workspacePath": "/Users/<your-username>/.ide/<your-directory-name>".

Nota

Se o nome do diretório do espaço de trabalho remoto não corresponder ao nome do seu projeto de código local, um ícone de aviso será exibido com esta mensagem: O nome do destino da sincronização remota não corresponde ao nome atual do espaço de trabalho do Visual Studio Code. Você pode ignorar esse aviso se não exigir que os nomes correspondam.

Depois de definir o diretório do espaço de trabalho, comece a sincronizar com o diretório do espaço de trabalho clicando no ícone de círculo de seta (Iniciar sincronização) ao lado de Destino da sincronização.

Importante

A extensão Databricks para Visual Studio Code executa apenas a sincronização automática unidirecional de alterações de arquivo do seu projeto local do Visual Studio Code para o diretório de espaço de trabalho relacionado em seu espaço de trabalho remoto do Azure Databricks. Os arquivos neste diretório de espaço de trabalho remoto devem ser transitórios. Não inicie alterações nesses arquivos de dentro do seu espaço de trabalho remoto, pois essas alterações não serão sincronizadas de volta ao seu projeto local.

Continue com as tarefas de desenvolvimento para a extensão Databricks para Visual Studio Code.