Painéis de controle de versão com Git

Esta página explica como usar as pastas Databricks Git para controle de versão e desenvolvimento colaborativo de painéis. Ele também descreve como implementar processos de CI/CD para desenvolver e implantar painéis em diferentes espaços de trabalho.

Descrição geral

Este recurso está no Public Preview.

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

Habilitar o controle do código-fonte do painel

Os administradores do espaço de trabalho podem controlar o acesso do espaço de trabalho à Pré-visualização Pública a partir da página Pré-visualizações. Por padrão, os painéis de suporte na visualização da pasta Git estão ativados.

Alternativa: Controlo manual de versões

Se não conseguir ativar a Pré-visualização Pública, utilize o seguinte fluxo de trabalho manual para acompanhar as versões do dashboard:

1. Exporte seu painel como um arquivo JSON. O formato de arquivo é lvdash.json. Consulte Exportar, importar ou substituir um painel de controlo para instruções de exportação.
2. Adicione esse arquivo a um sistema de controle de versão, como o Git.
3. Edite o arquivo. Você pode editar valores no arquivo de texto diretamente ou carregá-lo de volta ao seu espaço de trabalho e fazer alterações na interface do usuário.
4. Salve o novo arquivo. Se você tiver feito alterações na interface do usuário, exporte o novo arquivo. Use seu sistema de controle de versão para acompanhar as alterações e versões do painel.
5. Atualize o painel existente. A partir do rascunho do painel de controlo existente
   1. Clique no menu kebab no canto superior direito e, em seguida, clique em Substituir painel.
   2. Clique em Escolher ficheiro na caixa de diálogo Substituir painel a partir de ficheiro. Em seguida, clique em Substituir.

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

As pastas do Databricks Git rastreiam e gerenciam alterações em painéis de rascunho . O rascunho do painel reflete todas as alterações em um painel monitorizado. O Git não controla as configurações de publicação e agendamento, como a seleção de armazém e a criação de cronogramas. Para gerir estas configurações, use a interface ou automatize alterações com Declarative Automation Bundles ou a REST API AI/BI.

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

Observação

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

As pastas Databricks Git gerenciam operações comuns do Git para painéis e outros objetos de espaço de trabalho. Para obter mais detalhes, consulte Pastas Git do Azure Databricks.

Aplicando controle do código-fonte a painéis

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

• Novos painéis: Crie seu painel dentro de uma pasta existente do Databricks Git para aplicar o controle do código-fonte desde o início.
• Painéis existentes: Mova um painel existente para uma pasta Databricks Git para rastreá-lo com o Git.

Gerenciando permissões para painéis controlados pelo código-fonte

As permissões no nível da pasta aplicam-se 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 Git requer a permissão CAN MANAGE. Para mais informações, consulte ACLs de diretório e ACLs de diretório Git.

Fluxo de trabalho de desenvolvimento recomendado

Clone o repositório em sua própria pasta Databricks Git, use ramificações de recursos e envie solicitações pull. A tabela a seguir descreve como usar pastas Git para gerenciar painéis durante diferentes fases de desenvolvimento e implantação.

Importante

Mudar branches do Git é uma operação destrutiva para dashboards. O Azure Databricks remove painéis que não existem na ramificação de destino. Se você voltar, os painéis reaparecerão com novas URLs e IDs, o que interrompe links publicados, favoritos e integrações de API. Verifique o branch de destino antes de mudar e atualize todas as referências depois.

Fase do projeto	Workflow	Resultado esperado	Limitações conhecidas
Compromisso inicial	Mova o painel para uma pasta Git no espaço de trabalho. Commite 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 ramificações de desenvolvimento separadas, geralmente em suas pastas iniciais. Confirme alterações na ramificação de desenvolvimento. Mescle ramificações de desenvolvimento na main usando pull requests.	Os desenvolvedores trabalham de forma independente. O Git rastreia as versões do painel.	Os arquivos do painel usam o JSON formato. As consultas SQL aparecem como uma única linha, o que pode dificultar a revisão de diffs em solicitações pull.
Implementação	Crie uma pasta Git na ramificação de implantação numa pasta de nível superior não relacionada ao utilizador. Veja CI/CD com pastas do Databricks Git. Extraia as alterações para a pasta de implantação. Publique painéis a partir desta pasta. Remova o acesso edit+ e restrinja as atualizações ao Git. Partilhe dashboards com os consumidores.	Os consumidores acessam uma versão consistente e publicada do painel. Você pode compartilhar painéis na mesma pasta com públicos diferentes.	O Databricks não oferece suporte incorporado para sincronizar uma branch remota com uma pasta Git no espaço de trabalho, nem para implementar Declarative Automation Bundles com um recurso de dashboard a partir do remote. Configure a automação de CI/CD para automatizar: Obtendo atualizações do repositório remoto. Publicação de painéis após a sincronização. Implementação de Pacotes de Automação Declarativa após uma atualização.

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

Limitações

O controle do código-fonte com painéis de IA/BI tem as seguintes limitações:

• Você pode realizar um 'commit' de um máximo de 100 painéis em uma única pasta Git. Este limite pode ser alterado durante a Pré-visualização Pública.
• Trabalhos baseados em Git, como trabalhos que fazem referência a URLs do Git em vez de IDs ou caminhos de ativos de espaço de trabalho, não funcionam com painéis.
• A serialização do painel gera cadeias de caracteres longas, o que dificulta a leitura e a revisão de diferenças durante solicitações pull.
• O formato de 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.