Compartilhar via

Painéis de controle de versão com Git

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

Importante

Esse recurso está em uma versão prévia.

Visão geral

As pastas Git do Databricks acompanham as alterações e o histórico do painel, dão suporte à colaboração da equipe e permitem implantar painéis na produção e recuperar versões anteriores.

Habilitar o controle do código-fonte do painel

Os administradores do espaço de trabalho podem controlar o acesso à visualização pública na página Visualizações. Por padrão, a pré-visualização dos Painéis de Suporte na pasta Git está Ativada.

Como a integração do Git funciona com dashboards

As pastas Git do Databricks gerenciam e rastreiam alterações em dashboards de rascunho. O rascunho do painel de controle reflete todas as alterações em um painel monitorado. O Git não acompanha as configurações de publicação e agendamento, como seleção de armazém e criação de agendamento. Para gerenciar essas configurações, use a interface do usuário ou automatize as alterações com os Pacotes de Ativos do Databricks ou a API REST de IA/BI.

  • Para usar pacotes para o gerenciamento de painel, consulte o 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 Git do Databricks gerenciam operações comuns do Git para dashboards e outros objetos de workspace. Para saber mais, confira as pastas git do Azure Databricks.

Aplicando o controle do código-fonte a dashboards

Para gerenciar dashboards 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 do Databricks existente para aplicar o controle do código-fonte 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 dashboards controlados pelo código-fonte

As permissões no nível da 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 permissões específicas do painel. A maioria das operações do Git exige a permissão CAN MANAGE. Para saber mais, consulte ACLs de pasta e ACLs de pasta git.

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

Importante

Alternar ramificações do Git é uma operação destrutiva para dashboards. O Azure Databricks elimina dashboards que não existem no branch de destino. Se você alternar de volta, os painéis reaparecerão com novas URLs e IDs, que interrompem links, indicadores e integrações de API publicados. Verifique o branch de destino antes de alternar e atualizar todas as referências posteriormente.

Fase do projeto Workflow Resultado esperado Limitações conhecidas
Confirmação inicial
  • Mova o painel para uma pasta Git no workspace.
  • Confirme e envie por push para o repositório Git remoto.
 O Git rastreia o painel em um repositório remoto.
Desenvolvimento
  • Os desenvolvedores criam pastas Git em branches de desenvolvimento separados, normalmente em suas pastas domésticas.
  • Confirmar alterações no branch de desenvolvimento.
  • Mesclar branches de desenvolvimento à principal usando solicitações de pull.
  • Os desenvolvedores trabalham de forma independente.
  • O Git controla as versões do painel.
 Os arquivos do painel usam o formato JSON. As consultas SQL aparecem como uma única linha, o que pode tornar as diferenças difíceis de examinar em solicitações de pull.
Implantação
  • Crie uma pasta Git no branch de implantação em uma pasta de nível superior que não seja de usuário. Consulte CI/CD com pastas Git do Databricks.
  • Efetuar pull de alterações na pasta de implantação.
  • Publique painéis desta pasta.
  • Remova o acesso "edit+" e restrinja as atualizações ao Git.
  • Compartilhe dashboards com 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 fornece suporte integrado para sincronizar uma ramificação remota com uma pasta do Git no workspace, ou para implantar pacotes de ativos do Databricks com um recurso de painel a partir de uma fonte remota. Configure a automação de CI/CD para automatizar:
  • Obtendo atualizações do repositório remoto.
  • Publicar painéis após a sincronização.
  • Implantando pacotes de ativos do Databricks 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 commitar no máximo 100 dashboards em uma única pasta de repositório Git. Esse limite pode ser alterado durante a 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 do workspace, não funcionam com dashboards.
  • A serialização do painel gera cadeias de caracteres longas, o que torna difícil a leitura e a revisão das diferenças durante os pull requests.
  • O formato do arquivo do painel é alterado 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.
  • Last updated on