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 de painéis colaborativos. Ele também descreve como implementar processos de CI/CD para desenvolver e implantar painéis em diferentes espaços de trabalho.

info

Visualização

Esse recurso está em Public Preview.

Visão geral

As pastas Git Databricks rastreiam alterações e histórico do painel, dão suporte à colaboração da equipe e permitem que você atualize os painéis para produção e recupere versões anteriores.

Habilitar o controle de origem do painel

Os administradores do espaço de trabalho podem controlar o acesso do workspace à visualização pública na página Previews. Em default, a visualização do Support Dashboards na pasta Git está ativada .

Como funciona a integração do Git com painéis

As pastas Git Databricks rastreiam e gerenciam alterações em painéis de rascunho . O rascunho do painel reflete todas as alterações em um painel rastreado. Git não rastreia configurações de publicação e programação, como seleção de warehouse e criação de programação. Para gerenciar essas configurações, use a interface do usuário ou automatize as alterações com os pacotes ativos Databricks ou a API REST AI/BI .

• Para usar pacotes para gerenciamento de painéis, consulte painel.
• Para publicar e programar painéis com a API REST , consulte a referência API Lakeview .

nota

A API Lakeview usa o nome anterior para painéis de AI/BI .

As pastas Git Databricks gerenciam operações Git comuns para painéis e outros objetos workspace . Para saber mais, veja O que são pastas Git do Databricks.

Aplicando controle de origem aos painéis

Para rastrear painéis com o Git, coloque-os em uma pasta Git do Databricks. Use uma das seguintes opções:

• Novos painéis: crie seu painel dentro de uma pasta Git existente Databricks para aplicar o controle de origem 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 controlados pela fonte

Permissões em nível de pasta se aplicam a todos os objetos dentro dessa pasta, incluindo painéis. Os painéis em uma pasta Git herdam as permissões da pasta pai, além de quaisquer permissões específicas do painel. A maioria das operações do Git requer a permissão CAN MANAGE. Para saber mais, consulte ACLs de pasta e ACLs de pasta do Git.

Fluxo de trabalho de desenvolvimento recomendado

Clone o repositório na sua própria pasta Git Databricks , use branches de recurso e envie pull requests. A tabela a seguir descreve como usar pastas do Git para gerenciar painéis durante diferentes fases de desenvolvimento e implantação.

important

Alternar branches Git é uma operação destrutiva para painéis. O Databricks remove painéis que não existem no branch de destino. Se você voltar, os painéis reaparecerão com novos URLs e IDs, o que quebra links publicados, favoritos e integrações de API. Verifique o branch de destino antes de alternar e atualize todas as referências depois.

Fase do projeto	Workflow	Resultado esperado	Limitações conhecidas
Inicial commit	Mova o painel para uma pasta Git no workspace. Faça commit e envie para o repositório Git remoto.	O Git rastreia o painel em um repositório remoto.
Desenvolvimento	Os desenvolvedores criam pastas Git em branches dev separados, normalmente em sua pasta home. confirmar alterações no branch de desenvolvimento. mesclar branches de desenvolvimento ao principal usando pull requests.	Os desenvolvedores trabalham de forma independente. O Git rastreia versões do painel.	Os arquivos do painel usam o formato JSON . As consultas SQL aparecem como uma única linha, o que pode dificultar a revisão de diferenças em solicitações pull.
Implantação	Crie uma pasta Git no branch de implantação em uma pasta de nível superior não pertencente ao usuário. Veja CI/CD com pastas Git do Databricks (Repos). Puxe as alterações para a pasta de implantação. Publique painéis desta pasta. Remova o acesso edit+ e restrinja as atualizações ao Git. Compartilhe painéis com os consumidores.	Os consumidores acessam uma versão consistente e publicada do painel. Você pode compartilhar painéis na mesma pasta com diferentes públicos.	Databricks não fornece suporte integrado para sincronizar uma ramificação remota com uma pasta Git no workspace ou pacotes ativos Databricks com um recurso de painel remoto. Configure a automação de CI/CD para automatizar: Puxando atualizações do repositório remoto. Publicação de painéis após a sincronização. implantei Databricks ativo Bundles após uma atualização.

Para obter mais práticas recomendadas de colaboração nas pastas Git do Databricks, consulte Colaborar usando pastas Git.

Limitações

O controle de origem com painéis AI/BI tem as seguintes limitações:

• Você pode commit no máximo 100 painéis para uma única pasta Git . Esse limite pode mudar durante a Visualização Pública.
• Trabalhos baseados em Git , como trabalhos que referenciam URLs Git em vez de IDs ou caminhos ativos workspace , não funcionam com painéis.
• A serialização do painel gera strings longas, o que dificulta a leitura e a revisão das diferenças durante solicitações de pull.
• O formato do arquivo do painel muda periodicamente para incluir novos campos e outras melhorias. Durante a Visualização Pública, essas alterações podem aparecer como diferenças no Git que você não iniciou.