Pular para o conteúdo principal

Selecione um diretório workspace para a extensão Databricks do Visual Studio Code

nota

Este artigo se aplica a versões anteriores da extensão Databricks para Visual Studio Code. Para obter informações sobre a sincronização workspace da extensão Databricks para Visual Studio Code, versão 2 e superiores, consulte Sincronizar sua pasta workspace com Databricks.

Essa documentação foi descontinuada e pode não estar atualizada. O produto, serviço ou tecnologia mencionados neste conteúdo não são mais suportados.

Este artigo descreve como selecionar um diretório Databricks workspace para a extensão Databricks a ser usada pelo Visual Studio Code. Consulte O que é a extensão Databricks para o Visual Studio Code?

As informações a seguir pressupõem que o senhor já tenha configurado a extensão Databricks para o Visual Studio Code para autenticação com seu Databricks workspace. Consulte Configurar autorização para a extensão Databricks para Visual Studio Code.

nota

A extensão Databricks para o Visual Studio Code funciona somente com os diretórios workspace que ele cria. O senhor não pode usar um diretório workspace existente em seu workspace, a menos que ele 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 clustering Databricks deve ter instalado o Databricks Runtime 11.3 LTS ou superior.

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 Databricks Git 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 o projeto de código abertos e um perfil de configuração Databricks já definido, na paleta do comando (view > comando Palette ), digite Preferences: Open User Settings e clique em Preferences (Preferências): Open User Settings (Abrir configurações do usuário ).
  2. No site do usuário tab, expanda Extensions (Extensões ) e clique em Databricks .
  3. Para Sync: Destination Type , selecione workspace .
  4. Saia e reinicie o Visual Studio Code.

Observe que, depois de alterar a configuração do uso de uma pasta Databricks Git para o uso de diretórios workspace, talvez seja necessário ressincronizar manualmente o código com o diretório 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 projeto de código abertos, crie um novo diretório Databricks workspace que deseja usar ou selecione um diretório workspace existente que tenha sido criado anteriormente com a extensão.

Criar um novo diretório workspace

Para criar um novo diretório workspace, 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 Create New Sync Destination (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 dentro de /Users/<your-username>/.ide no workspace e, em seguida, 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>".

nota

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

  1. Depois de definir o diretório workspace, inicie a sincronização com o diretório workspace clicando no ícone do círculo com seta (começar a sincronização ) ao lado de Sync Destination .

    começar ícone de sincronização 1

important

A extensão Databricks para o Visual Studio Code executa apenas a sincronização automática unidirecional das alterações de arquivos do projeto local do Visual Studio Code para o diretório workspace relacionado no diretório remoto Databricks workspace. Os arquivos nesse diretório remoto workspace devem ser transitórios. Não inicie alterações nesses arquivos a partir do site remoto workspace, pois essas alterações não serão sincronizadas de volta ao projeto local.

Reutilizar um diretório workspace existente

Se o senhor já tiver um diretório workspace criado anteriormente com a extensão Databricks para o Visual Studio Code e quiser reutilizá-lo 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 ).

    Configurar ícone de destino de sincronização 2

  2. Na paleta de comandos , 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>".

nota

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

Depois de definir o diretório workspace, inicie a sincronização com o diretório workspace clicando no ícone do círculo com seta (começar a sincronização ) ao lado de Sync Destination .

começar ícone de sincronização 2

important

A extensão Databricks para o Visual Studio Code executa apenas a sincronização automática unidirecional das alterações de arquivos do projeto local do Visual Studio Code para o diretório workspace relacionado no diretório remoto Databricks workspace. Os arquivos nesse diretório remoto workspace devem ser transitórios. Não inicie alterações nesses arquivos a partir do site remoto workspace, pois essas alterações não serão sincronizadas de volta ao projeto local.