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

Nota

Este artigo aplica-se a versões anteriores da extensão Databricks para Visual Studio Code. Para informações de sincronização de espaço de trabalho para a extensão Databricks para Visual Studio Code, versão 2 e superiores, veja Sincronizar a pasta do seu espaço de trabalho com Databricks.

Esta documentação foi desativada e pode não ser atualizada. Os produtos, serviços ou tecnologias mencionados neste conteúdo não são mais suportados.

Este artigo descreve como selecionar um diretório de espaço de trabalho do Azure Databricks para a extensão Databricks for Visual Studio Code utilizar. Ver extensão Databricks para Visual Studio Code

A informação seguinte assume que já tem configurado a extensão Databricks para Visual Studio Code para autenticação com o seu espaço de trabalho Azure Databricks. Consulte Configurar autorização 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 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 workspace com a extensão Databricks para Visual Studio Code, deve usar a versão 0.3.5 ou superior da extensão, e o seu cluster Azure Databricks deve ter 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 o seu projeto de código abertos, e um perfil de configuração Azure Databricks já definido, na Paleta de Comandos (Visualizar > Paleta de Comandos), escreva Preferences: Open User Settings e depois clique em Preferências: Abrir Definições de Utilizador.
  2. Na guia Usuário, expanda Extensões e clique em Databricks.
  3. Em Sync: Destination Type, selecione workspace.
  4. Sai e reinicia 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 com seta (Iniciar sincronização) ao lado de Destino de Sincronização.

Iniciar ícone de sincronização 0

Com a extensão e o seu projeto de código abertos, crie um novo diretório de espaço de trabalho do Azure Databricks que queira usar, ou selecione um diretório de espaço de trabalho existente que 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).

    Configurar ícone de destino de sincronização 1

  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 de /Users/<your-username>/.ide no espaço de trabalho e em seguida adiciona o caminho do diretório do espaço de trabalho ao arquivo .databricks/project.json do projeto de 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 local de código, aparece um ícone de aviso com esta mensagem: O nome do destino de 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 com seta (Iniciar sincronização) ao lado de Destino da Sincronização.

    Ícone Iniciar sincronização 1

Importante

A extensão Databricks para Visual Studio Code realiza apenas a sincronização automática unidirecional das alterações de ficheiros do seu projeto local Visual Studio Code para o diretório de espaço de trabalho relacionado no 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.

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

Se tem um diretório de espaço de trabalho existente que criou anteriormente com a extensão Databricks para Visual Studio Code e quer reutilizar no seu projeto atual do Visual Studio Code, então 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).

    Configurar ícone de destino de sincronização 2

  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 de código do projeto .databricks/project.json, 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 local de código, aparece um ícone de aviso com esta mensagem: O nome do destino de 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 com seta (Iniciar sincronização) ao lado de Destino da Sincronização.

Ícone Iniciar sincronização 2

Importante

A extensão Databricks para Visual Studio Code realiza apenas a sincronização automática unidirecional das alterações de ficheiros do seu projeto local Visual Studio Code para o diretório de espaço de trabalho relacionado no 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.