Painéis de controle de origem

Este artigo explica como usar as pastas Databricks Git para controle de versão e desenvolvimento colaborativo de painéis. Ele também fornece orientação sobre a implementação de processos 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

O uso das pastas Databricks Git para painéis oferece melhor visibilidade das alterações e do histórico, tornando a colaboração mais eficiente. Ele também simplifica a implantação de painéis de controle na produção e permite que o senhor recupere versões anteriores, servindo como uma solução confiável de backup.

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 a integração do Git funciona com os painéis

O senhor pode usar as pastas Git do Databricks para rastrear e gerenciar as alterações nos painéis de rascunho . Todas as alterações em um painel monitorado são refletidas no rascunho do painel. As configurações de publicação e programação, como a seleção do depósito e a criação da programação, não são rastreadas. Para gerenciar essas configurações, use a interface do usuário ou automatize as alterações usando Databricks ativo Bundles ou o AI/BI REST API. Consulte o dashboard e a referência da API REST do Lakeview.

nota

AI/BI Os painéis eram conhecidos anteriormente como Lakeview dashboards. A API Lakeview mantém esse nome.

• Para saber mais sobre o uso de pacotes para gerenciamento de painéis, consulte Painel.
• Para obter detalhes sobre como publicar e programar dashboards pelo site REST API, consulte a Lakeview API referência.

Databricks Git As pastas oferecem uma maneira centralizada de gerenciar operações comuns Git para dashboards e outros objetos workspace. Para saber mais, consulte Integração do Git para pastas Git do Databricks.

Aplicação do 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 em uma pasta existente Databricks Git para aplicar o controle de origem desde o início.
• Painéis existentes : Mova um painel existente para uma pasta Git da Databricks para rastreá-lo com o Git.

Gerenciando permissões para painéis controlados pela fonte

Assim como ocorre com outros objetos do site workspace, as permissões definidas no nível da pasta se aplicam a todos os objetos dentro dessa pasta. Os painéis em uma pasta Git herdam as permissões da pasta principal, além de quaisquer permissões específicas do painel. Os usuários devem ter permissão CAN_MANAGE para realizar a maioria das operações do Git. Para saber mais,consulte ACLs de pasta e ACLs de pasta do Git.

Desenvolvimento recomendado fluxo de trabalho

Os usuários devem clonar o repositório em sua própria pasta Databricks Git , usar branches de recurso e enviar pull requests. A tabela a seguir descreve sugestões para o uso de pastas Git para gerenciar painéis durante diferentes fases de desenvolvimento e implantação.

Fase do projeto	Workflow	Resultado esperado	Limitações conhecidas
Inicial commit	Mova o painel para uma pasta Git no site workspace. - confirmar e enviar para o repositório remoto Git.	O painel agora tem controle de origem em um repositório Git remoto.
Desenvolvimento	Os desenvolvedores criam pastas Git em ramificações de desenvolvimento separadas, geralmente em sua pasta home. - confirmar as alterações no ramo de desenvolvimento. - Faça o merge das ramificações de desenvolvimento para a principal usando pull requests.	Os desenvolvedores podem trabalhar de forma independente. - Os painéis são controlados por versão.	Os arquivos do painel estão no formato JSON. As consultas SQL aparecem como uma única linha, o que pode dificultar a revisão das diferenças nas solicitações 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 as técnicas de CI/CD com pastas Git e Databricks Git (Repos). - Puxe as alterações para a pasta de implantação. - Publique painéis a partir dessa 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. - Os painéis na mesma pasta podem ser compartilhados com públicos diferentes.	Não há suporte integrado para a sincronização de uma ramificação remota com uma pasta Git no site workspace, ou para a implantação de pacotes ativos Databricks com um recurso de painel do site remoto. 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. - implantado Databricks ativo Bundles após uma atualização.

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

Limitações

Considere as seguintes limitações ao usar o controle de origem com os painéis do AI/BI:

• Um máximo de 100 painéis pode ser confirmado em uma única pasta Git. Esse limite pode ser modificado durante o período de visualização pública.
• GitNão há suporte para trabalhos com base em URLs, como os que fazem referência a URLs Git em vez de IDs ou caminhos workspace ativos.
• A serialização do painel gera longos strings, dificultando a leitura e a revisão das diferenças durante as solicitações pull.
• O formato do arquivo do painel muda periodicamente para incluir novos campos e outras melhorias. Durante o período de visualização pública, essas alterações podem aparecer como diferenças no Git que não estão relacionadas a edições iniciadas pelo usuário.