Painéis de controle de versão com Git
Esta página explica como usar as pastas Git do Databricks para controle de versão e desenvolvimento colaborativo de dashboards. O documento também descreve como implementar processos de CI/CD para desenvolver e implantar dashboards em diferentes espaços de trabalho.
Visão geral
As pastas Git Databricks rastreiam as alterações e o histórico dos painéis, oferecem suporte à colaboração em equipe e permitem implantar painéis em produção e recuperar versões anteriores.
Ativar controle de origem do painel de controle
Os administradores do Workspace podem controlar o acesso ao Workspace na página de Pré-visualizações. Por default, a configuração Suporte a Dashboards em pasta Git está Ativada .
Alternativa: Controle de versão manual
Se você não conseguir habilitar pastas do Git, use o seguinte fluxo de trabalho manual para rastrear versões de dashboard:
- Exporte seu painel de controle como um arquivo JSON. O formato do arquivo é
lvdash.json. Consulte Exportar, importar ou substituir um painel de controlo para obter instruções de exportação. - Adicione esse arquivo a um sistema de controle de versão, como o Git.
- Edite o arquivo. Você pode editar os valores diretamente no arquivo de texto ou upload lo de volta para seu workspace e fazer alterações na interface do usuário.
- Salve o novo arquivo. Se você fez alterações na interface do usuário, exporte o novo arquivo. Utilize seu sistema de controle de versão para rastrear alterações e versões do painel de controle.
- Atualize o painel de controle existente. A partir do rascunho existente do painel de controle:
- Clique no
No canto superior direito, clique em "Substituir painel" .
- Clique em "Escolher arquivo" na caixa de diálogo "Substituir arquivo" do painel de controle . Em seguida, clique em Sobrescrever .
- Clique no
Como a integração do Git funciona com os painéis de controle
As pastas Git Databricks rastreiam e gerenciam alterações em rascunhos de painéis. O rascunho do painel reflete todas as alterações em um painel monitorado. Git não rastreia configurações de publicação e programação, como seleção de repositório e criação de programas. Para gerenciar essas configurações, use a interface do usuário ou automatize as alterações com os Pacotes de Automação Declarativa ou a API REST AI/BI .
- Para usar pacotes para gerenciamento de painéis, consulte painel.
- Para publicar e programar dashboards com a API REST , consulte a referência API Lakeview .
A API Lakeview usa o nome anterior para painéis de AI/BI .
As pastas Git Databricks gerenciam operações Git comuns para dashboards e outros objetos workspace . Para saber mais, consulte Pastas Git do Databricks.
Aplicando controle de versão a painéis de controle
Para rastrear dashboards com Git, coloque-os em uma pasta Git do Databricks. Utilize uma das seguintes opções:
- Novos painéis: Crie seu painel dentro de uma pasta Git existente Databricks para aplicar o controle de versão desde o início.
- Painéis existentes: Mova um painel existente para uma pasta Git do Databricks para rastreá-lo com o Git.
Gerenciando permissões para painéis com controle de versão
As permissões em nível de pasta são aplicadas a todos os objetos dentro dessa pasta, incluindo dashboards. Os dashboards em uma pasta Git herdam as permissões da pasta pai além de quaisquer permissões específicas do dashboard. A maioria das operações Git requer a permissão CAN MANAGE (Pode gerenciar). Para saber mais, consulte Gerenciar listas de controle de acesso com pastas e ACLs de pasta Git.
Fluxo de trabalho de desenvolvimento recomendado
Clone o repositório para sua própria pasta Git Databricks , use branches de recurso e envie solicitações de pull. A tabela a seguir descreve como usar pastas Git para gerenciar painéis durante diferentes fases de desenvolvimento e implantação.
A troca de branches Git é uma operação destrutiva para dashboards. O Databricks remove dashboards que não existem na branch de destino. Se você voltar à versão anterior, os painéis reaparecerão com novos URLs e IDs, o que quebrará os links publicados, os favoritos e as integrações de API. Verifique a ramificação de destino antes de alternar e atualize todas as referências em seguida.
Fase do projeto | Workflow | Resultado esperado | Limitações conhecidas |
|---|---|---|---|
commitinicial |
| O Git rastreia o painel de controle em um repositório remoto. | |
Desenvolvimento |
|
| |
Implantação |
|
| Databricks não oferece suporte integrado para sincronizar um branch remoto com uma pasta Git no workspace, nem para implantar Declarative Automation Bundles com um recurso de dashboard remoto. Configure a automação de CI/CD para automatizar:
|
Para obter mais informações sobre as melhores práticas de colaboração em pastas Git do Databricks, consulte Colaborar usando pastas Git.
Limitações
O controle de versão com dashboards AI/BI apresenta as seguintes limitações:
- Tarefas baseadas em Git , como tarefas que referenciam URLs Git em vez de IDs ou caminhos ativos workspace , não funcionam com painéis de controle.
- Os widgets de imagem que usam arquivos upload ou imagens de Workspace armazenam uma referência ao caminho do Workspace de cada arquivo de imagem. Em uma pasta Git ou workspace diferente, essas imagens não são carregadas, a menos que os arquivos estejam disponíveis nos mesmos caminhos. Veja Exportar, importar e clonar.