Pular para o conteúdo principal

Uso de pastas Git com a extensão Databricks para Visual Studio Code

nota

Databricks recomenda o uso dos arquivos workspace ao configurar a extensão Databricks para o Visual Studio Code.

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. A documentação fornecida aqui cobre 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 a extensão Databricks para o Visual Studio Code.

A extensão Databricks para o Visual Studio Code suporta o trabalho com arquivos em Databricks Git pastas dentro do Databricks workspace. Databricks Git As pastas eram a sincronização do default antes da versão 0.3.15, mas não é mais recomendado.

Arquivos em pastas Git é ativado por default em todos os espaços de trabalho Databricks, mas pode ser desativado por administradores usando o REST API. Entre em contato com o administrador do site workspace se não conseguir acessar essa funcionalidade.

important

A extensão Databricks para o Visual Studio Code funciona apenas com repositórios criados por ele. O senhor deve ter permissões de execução para um cluster Databricks para executar o código, bem como permissões para criar um repositório nas pastas Databricks Git .

Defina o repositório

Se optar por usar uma pasta Databricks Git em vez de um diretório workspace em seu Databricks workspace, então, com a extensão e seu projeto de código abertos e um perfil de configuração Databricks já definido, use a extensão Databricks para Visual Studio Code para criar um novo repositório nas 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.

nota

A extensão Databricks para o Visual Studio Code funciona apenas com repositórios criados por ele. O senhor não pode usar um repositório existente em seu site workspace.

Para habilitar a extensão Databricks para o Visual Studio Code para usar repositórios em Databricks Git pastas dentro de um Databricks workspace, o senhor deve primeiro definir a configuração Sync: Destination Type da extensão para repo 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. Em Sincronização: Tipo de destino , selecione repositório .
  4. Saia e reinicie o Visual Studio Code.

Crie 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 ícone de destino de sincronização 3

  2. Na paleta de comandos , clique em Create New Sync Destination (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 workspace do repositório ao arquivo .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, 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 repositório, comece a sincronizar com o repositório clicando no ícone do círculo com seta (começar a sincronização ) ao lado de Sync Destination .

    começar ícone de sincronização 3

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 repositório relacionado no site remoto Databricks workspace. Esses arquivos do repositório remoto devem ser transitórios. Não inicie alterações nesses arquivos de dentro do seu repositório remoto, pois essas alterações não serão sincronizadas de volta ao seu projeto local.

Reutilize um repositório existente

Se o senhor tiver um repositório existente nas pastas Git da Databricks que criou anteriormente com a extensão da 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 4

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

    A extensão adiciona o caminho workspace do repositório ao arquivo .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, 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 repositório, comece a sincronizar com o repositório clicando no ícone do círculo com seta (começar a sincronização ) ao lado de Sync Destination .

    Começar ícone de sincronização 4

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 repositório relacionado no site remoto Databricks workspace. Esses arquivos do repositório remoto devem ser transitórios. Não inicie alterações nesses arquivos de dentro do seu repositório remoto, pois essas alterações não serão sincronizadas de volta ao seu projeto local.