Usando pastas Git com extensão Databricks para Visual Studio Code

Nota

O Databricks recomenda o uso de arquivos de espaço de trabalho ao configurar a extensão Databricks para Visual Studio Code.

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. A documentação fornecida aqui abrange apenas as especificidades da configuração de pastas Git para a extensão Databricks para Visual Studio Code. Para obter a documentação completa, consulte Extensão Databricks para Visual Studio Code.

A extensão Databricks para Visual Studio Code dá suporte ao trabalho com arquivos em pastas Databricks Git dentro do espaço de trabalho Azure Databricks. As pastas Databricks Git eram a sincronização padrão antes da versão 0.3.15, mas não são mais recomendadas.

Os arquivos nas pastas do Git são habilitados por padrão em todos os espaços de trabalho do Azure Databricks, mas podem ser desabilitados pelos administradores usando a API REST. Entre em contato com o administrador do espaço de trabalho se não conseguir acessar essa funcionalidade.

Importante

A extensão Databricks para Visual Studio Code funciona apenas com repositórios que ele cria. Você deve ter permissões de execução para um cluster do Azure Databricks para executar código, bem como permissões para criar um repositório em pastas Git do Databricks.

Definir o repositório

Se você optar por usar uma pasta Databricks Git em vez de um diretório de espaço de trabalho em seu espaço de trabalho do Azure Databricks, então, com a extensão e seu projeto de código abertos, e um perfil de configuração do Azure Databricks já definido, use a extensão Databricks para Visual Studio Code para criar um novo repositório em pastas Databricks Git e usá-lo, ou selecione um repositório existente nas pastas Databricks Git que você criou anteriormente com a extensão Databricks para Visual Studio Code e deseja reutilizar em vez disso.

Nota

A extensão Databricks para Visual Studio Code funciona apenas com repositórios que ele cria. Não é possível usar um repositório existente em seu espaço de trabalho.

Para habilitar a extensão Databricks para Visual Studio Code para usar repositórios em pastas Git Databricks dentro de um espaço de trabalho do Azure Databricks, você deve primeiro definir a configuração Sync: Destination Type da extensão para repo da seguinte maneira:

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

Criar um novo repositório

Para criar um novo repositório, 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 o ícone de destino de sincronização 3

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

  3. Digite um nome para o novo repositório nas pastas Git do Databricks e pressione Enter.

    A extensão acrescenta os caracteres .ide ao final do nome do repositório e, em seguida, adiciona o caminho do espaço de trabalho do repositório ao arquivo de .databricks/project.json do projeto de código, por exemplo "workspacePath": "/Workspace/Repos/someone@example.com/my-repo.ide".

    Nota

    Se o nome do repositório 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 repositório, comece a sincronizar com o repositório clicando no ícone de círculo de seta (Iniciar sincronização) ao lado de Destino de Sincronização.

    Ícone Iniciar sincronização 3

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 repositório relacionado em seu espaço de trabalho remoto do Azure Databricks. Esses arquivos de repositório remoto destinam-se a ser transitórios. Não inicie alterações nesses arquivos de dentro do repositório remoto, pois essas alterações não serão sincronizadas de volta ao seu projeto local.

Reutilizar um repositório existente

Se você tiver um repositório existente em pastas Databricks Git 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).

    Configurar ícone de destino de sincronização 4

  2. Na Paleta de comandos, selecione o nome do repositório na lista.

    A extensão adiciona o caminho do espaço de trabalho do repositório ao ficheiro do projeto de código-fonte .databricks/project.json, por exemplo, "workspacePath": "/Workspace/Repos/someone@example.com/my-repo.ide".

    Nota

    Se o nome do repositório 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.

  3. Depois de definir o repositório, comece a sincronizar com o repositório clicando no ícone de círculo de seta (Iniciar sincronização) ao lado de Destino de Sincronização.

    Ícone Iniciar sincronização 4

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 repositório relacionado em seu espaço de trabalho remoto do Azure Databricks. Esses arquivos de repositório remoto destinam-se a ser transitórios. Não inicie alterações nesses arquivos de dentro do repositório remoto, pois essas alterações não serão sincronizadas de volta ao seu projeto local.

  • Last updated on