Conceito e mecanismo
Git folders permite desenvolver notebooks e ficheiros com branches, commits, comparação de alterações e sincronização com um repositório. Um commit local não significa que a alteração foi enviada para o remoto; push e revisão fazem parte do percurso de colaboração.
Evita transformar uma pasta editável partilhada na referência implícita de produção. A documentação atual recomenda Declarative Automation Bundles, anteriormente Databricks Asset Bundles, e artefactos versionados para deployments de produção.
O bundle descreve recursos e configurações, incluindo targets para ambientes diferentes. Mantém código comum e explicita diferenças de catálogo, identidade, parâmetros e recursos. Credenciais devem ser resolvidas por mecanismos adequados, sem serem guardadas no repositório.
Aplicação guiada
Num exercício, o bundle valida, mas a consulta usa um catálogo de desenvolvimento escrito diretamente no código. bundle validate verifica configuração contra schemas; não prova que a lógica cumpre o contrato nem que os resultados pertencem ao ambiente pretendido.
Revê a configuração resolvida e executa verificações de integração e reconciliação num ambiente controlado. O comando deploy cria ou atualiza recursos; run inicia execução. Regista commit, versão do artefacto, target, identidade e resultado.
Se for necessário regressar à versão anterior, avalia também alterações de dados e efeitos externos, porque reverter código não desfaz automaticamente escritas. A decisão de promoção deve ligar a versão a evidência concreta de funcionamento e recuperação.
Configuração válida pode executar lógica errada no catálogo errado.
Armadilhas comuns
Commit sem push; target ignorado; validate como teste funcional; rollback de código como rollback de dados.
Tópicos relacionados: Plataforma, compute e contratos de dados · Ingestão incremental, estado e esquema · Transformação, granularidade e qualidade
Promove uma versão identificável, com configuração revista e resultados reconciliados.
Referências
- Declarative Automation Bundles lifecycle · Current Databricks documentation inspected 2026-10-01; feature-specific runtime limits retained
- Git folders concepts · Current Databricks documentation inspected 2026-10-01; feature-specific runtime limits retained
- Validate deploy and run a bundle · Current Databricks documentation inspected 2026-10-01; feature-specific runtime limits retained
- Git integration and production guidance · Current Databricks documentation inspected 2026-10-01; feature-specific runtime limits retained