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 workspace do Databricks para uso da extensão Databricks para Visual Studio Code. Consulte O que é a extensão Databricks para Visual Studio Code?

Observação

Este artigo se aplica somente à extensão Databricks para Visual Studio Code, versão 1.

A extensão Databricks para Visual Studio Code, versão 2, atualmente em Private Preview, determina automaticamente o diretório Databricks workspace a ser usado com base nas configurações do Databricks ativo Bundle associado ao projeto. Se o senhor estiver usando a extensão Databricks para Visual Studio Code, versão 2, pule para a tarefa Desenvolvimento da extensão Databricks para Visual Studio Code.

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

Observação

Se você já concluiu o tutorial da extensão VSCode para Databricks: execução do Python em clusters e como Job e deseja continuar usando o diretório workspace desse tutorial, avance para a tarefa de desenvolvimento da extensão Databricks para Visual Studio Code.

Observação

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

Para usar os diretórios workspace com a extensão Databricks para Visual Studio Code, o senhor deve usar a versão 0.3.5 ou superior da extensão, e o seu Databricks cluster deve ter o Databricks Runtime 11.3 LTS ou superior instalado.

workspace directories é a configuração default, a partir da versão 0.3.15 da extensão. No entanto, se o senhor configurar a extensão para usar uma pasta Git do Databricks em vez de um diretório workspace, poderá configurar a extensão novamente para usar os diretórios workspace da seguinte forma:

  1. Com a extensão e seu projeto de código abertos, e um perfil de configuração do Databricks já definido, na paleta de comando (view > comando Palette), digite Preferences: Open User Settings e clique em Preferences: Open User Settings.

  2. Na Usuário tab, expanda Extensões e clique em Databricks .

  3. Para Sincronização: Tipo de Destino, selecione workspace.

  4. Saia e reinicie o Visual Studio Code.

Observe que, depois de alterar a configuração do uso de uma pasta Git do Databricks para o uso de diretórios workspace, talvez seja necessário ressincronizar manualmente o código com o workspace. Para fazer isso, depois de criar um novo diretório workspace no próximo procedimento, clique no ícone do círculo com seta(começar a sincronização) ao lado de Sync Destination.

começar ícone de sincronização 0

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

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

Para criar um novo diretório workspace , faça o seguinte:

  1. No painel Configuração , próximo a 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 workspace e pressione Enter.

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

    Observação

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

  4. Depois de configurar o diretório workspace , comece a sincronizar com o diretório workspace clicando no ícone de círculo com seta (começar sincronização) próximo a Destino de Sincronização.

    começar ícone de sincronização 1

Importante

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

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

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

Se você tiver um diretório workspace existente criado anteriormente com a extensão Databricks para Visual Studio Code e quiser reutilizá-lo em seu projeto Visual Studio Code atual, faça o seguinte:

  1. No painel Configuração , próximo a 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 comando, selecione o nome do diretório workspace na lista.

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

Observação

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

Depois de configurar o diretório workspace , comece a sincronizar com o diretório workspace clicando no ícone de círculo com seta (começar sincronização) próximo a Destino de Sincronização.

começar ícone de sincronização 2

Importante

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

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