Pular para o conteúdo principal
Última atualização em

Git Folder Serverless

info

Beta

Esse recurso está em Beta.

O Git Folder Serverless fornece um único recurso de compute serverless compartilhado entre ativos em uma pasta Git, incluindo notebooks e arquivos. Use o Git Folder Serverless para autoria de vários arquivos sem iniciar um novo recurso de compute serverless ou configurar um ambiente para cada notebook ou arquivo. O ambiente é gerenciado por um arquivo pyproject.toml na raiz da pasta Git.

Requisitos​

Para usar o Serverless de Pasta Git:

  • Seu projeto deve estar em uma pasta Git.
  • É necessário abrir a pasta Git no editor de pastas Git.
  • Se a pasta Git contiver um arquivo raiz pyproject.toml, o environment_version deverá ser definido como 5 ou posterior.

Compute compartilhado e ambiente​

  • Notebooks e arquivos na mesma pasta Git são anexados a um recurso de compute Serverless de pasta Git e usam o ambiente gerenciado por pyproject.toml.
  • Apenas ativos dentro da pasta Git associada podem ser anexados ao recurso de compute.
  • As variáveis Python definidas em um notebook não estão disponíveis em outro notebook.
  • Um terminal web aberto a partir de qualquer notebook ou arquivo anexado na pasta Git é executado no mesmo recurso de compute.

Use o Git Folder Serverless no editor de pastas Git​

  1. Na barra lateral do workspace, clique em Workspace e navegue até a pasta Git.

  2. Clique em Abrir no editor .

  3. Abra um notebook ou arquivo na pasta Git.

  4. Clique no menu suspenso de compute.

  5. Selecione Git Folder Serverless .

    Menu suspenso Compute mostrando Git Folder Serverless selecionado com a versão de ambiente 5

  6. Execute o notebook ou arquivo para iniciar o recurso de compute.

Para usar o mesmo compute de outro ativo, abra outro notebook ou arquivo na mesma pasta Git e selecione Git Folder Serverless . Os ativos compartilham o compute e o ambiente gerenciado por pyproject.toml.

Gerencie o ambiente com pyproject.toml​

O Git Folder Serverless gerencia dependências Python para toda a pasta Git com um arquivo pyproject.toml na raiz da pasta. Isso difere dos notebooks serverless padrão, onde as dependências configuradas no painel lateral Ambiente se aplicam a um único notebook.

Você pode adicionar dependências e aplicar alterações de ambiente com comandos de notebook ou editando pyproject.toml.

Use comandos de notebook​

  1. Abra um notebook anexado ao Git Folder Serverless.

  2. Verifique se um arquivo pyproject.toml existe na raiz da pasta Git. Se ele não existir, abra o painel lateral Environment e clique em Create pyproject.toml .

  3. Execute %uv add <package> para adicionar uma dependência ao arquivo pyproject.toml raiz. Por exemplo:

    Python
    %uv add cowsay

  4. Execute %uv sync para aplicar as dependências ao ambiente compartilhado e gerar ou atualizar uv.lock.

    Python
    %uv sync

Editar pyproject.toml​

  1. No editor de pastas Git, verifique se um arquivo pyproject.toml existe na raiz da pasta Git. Se ele não existir, abra o painel lateral Environment e clique em Create pyproject.toml .

  2. Abra o arquivo pyproject.toml.

  3. Edite manualmente a lista dependencies. Por exemplo:

    Toml
    [project]
    name = "my-project"
    version = "0.1.0"
    dependencies = [
      "simplejson==3.18.1",
    ]

    [tool.databricks.environment]
    environment_version = "5"

  4. Na parte superior do editor de arquivos pyproject.toml, clique em Aplicar para aplicar as alterações de ambiente ao Git Folder Serverless.

O ambiente atualizado está disponível para notebooks e arquivos conectados ao mesmo compute Serverless de pasta Git. Para inspecionar o ambiente, abra o painel lateral Ambiente . Consulte Configurar o ambiente serverless para obter informações sobre versões de ambiente serverless e dependências instaladas.

Colabore através do Git​

Apenas o usuário que inicia um recurso de compute Serverless de pasta Git pode executar cargas de trabalho nele. Se outro usuário abrir a mesma pasta Git, ele será impedido de executar notebooks ou arquivos no recurso de compute existente.

O Databricks recomenda que cada colaborador clone o repository em uma pasta Git na sua pasta de workspace pessoal. Cada colaborador obtém então um recurso de compute separado e um ambiente gerenciado por pyproject.toml para seu clone.

Utilize branches, commits, pushes e pulls para trocar alterações por meio do repository Git remoto. Consulte Colaborar em pastas Git.

Limitações​

  • O compartilhamento de compute é limitado a uma política de uso serverless. Notebooks e arquivos na mesma pasta Git que usam políticas de uso diferentes recebem recursos de compute separados em vez de compartilhar um.

Outros recursos​

Nesta página