Dashboards voor broncodebeheer

In dit artikel wordt uitgelegd hoe u Databricks Git-mappen gebruikt voor versiebeheer en ontwikkeling van het gezamenlijke dashboard. Het biedt ook richtlijnen voor het implementeren van CI/CD-processen voor het ontwikkelen en implementeren van dashboards in verschillende werkruimten.

Belangrijk

Deze functie bevindt zich in openbare preview.

Overzicht

Het gebruik van Databricks Git-mappen voor dashboards biedt een beter inzicht in wijzigingen en geschiedenis, waardoor samenwerking efficiënter wordt. Het vereenvoudigt ook het implementeren van dashboards naar productie en stelt u in staat eerdere versies te herstellen, die fungeren als een betrouwbare back-upoplossing.

Dashboardbronbeheer inschakelen

Werkruimtebeheerders kunnen de toegang van werkruimten tot de openbare preview beheren via de pagina Previews. De preview-versie van de ondersteuningsdashboards in git-mappen is standaard ingeschakeld.

Hoe Git-integratie werkt met dashboards

U kunt Databricks Git-mappen gebruiken om wijzigingen in conceptdashboards bij te houden en te beheren. Alle wijzigingen in een bijgehouden dashboard worden weerspiegeld in het concept-dashboard. Publicatie- en planningsconfiguraties, zoals het maken van magazijnselectie en planning, worden niet bijgehouden. Als u deze configuraties wilt beheren, gebruikt u de gebruikersinterface of automatiseert u wijzigingen met behulp van Databricks Asset Bundles of de AI/BI REST API. Zie het dashboard en de Lakeview REST API-referentie.

Opmerking

AI-/BI-dashboards werden voorheen Lakeview-dashboards genoemd. De Lakeview-API behoudt die naam.

• Zie het dashboard voor meer informatie over het gebruik van bundels voor dashboardbeheer.
• Raadpleeg de Lakeview-API-referentie voor details over het publiceren en plannen van dashboards via de REST API.

Databricks Git-mappen bieden een gecentraliseerde manier om algemene Git-bewerkingen voor dashboards en andere werkruimteobjecten te beheren. Zie Git-integratie voor Databricks Git-mappen voor meer informatie.

Broncodebeheer toepassen op dashboards

Als u dashboards wilt bijhouden met Git, plaatst u ze in een Databricks Git-map. Gebruik een van de volgende opties:

• Nieuwe dashboards: Maak uw dashboard in een bestaande Databricks Git-map om vanaf het begin broncodebeheer toe te passen.
• Bestaande dashboards: Verplaats een bestaand dashboard naar een Databricks Git-map om het bij te houden met Git.

Machtigingen beheren voor door de bron beheerde dashboards

Net als bij andere werkruimteobjecten zijn machtigingen die op mapniveau zijn ingesteld, van toepassing op alle objecten in die map. Dashboards in een Git-map nemen de machtigingen van de bovenliggende map over, naast eventuele dashboardspecifieke machtigingen. Gebruikers moeten CAN_MANAGE machtiging hebben om de meeste Git-bewerkingen uit te voeren. Voor meer informatie, zie Map-ACLs en Git-map-ACLs.

Aanbevolen ontwikkelwerkstroom

Gebruikers moeten de opslagplaats klonen in hun eigen Databricks Git-map, functiebranches gebruiken en pull-aanvragen indienen. De volgende tabel bevat suggesties voor het gebruik van Git-mappen voor het beheren van dashboards tijdens verschillende fasen van ontwikkeling en implementatie.

Projectfase	Werkstroom	Verwacht resultaat	Bekende beperkingen
Initiale commit	Verplaats het dashboard naar een Git-map in de werkruimte. Doorvoeren en pushen naar de externe Git-opslagplaats.	Het dashboard wordt nu beheerd via een externe Git-opslagplaats.
Ontwikkeling	Ontwikkelaars maken Git-mappen in afzonderlijke ontwikkeltakken, meestal in hun thuisdirectories. Wijzigingen doorvoeren in de ontwikkelbranch. Ontwikkelbranches samenvoegen naar main met behulp van pull requests.	Ontwikkelaars kunnen onafhankelijk werken. Dashboards staan onder versiebeheer.	Dashboardbestanden zijn in JSON-formaat. SQL-query's worden weergegeven als één regel, waardoor verschillen moeilijk te controleren zijn in pull-aanvragen.
Implementatie	Maak een Git-map op de implementatiebranch in een niet-gebruikersmap op het hoogste niveau. Zie CI/CD met Databricks Git-repositories (repos). Haal wijzigingen op naar de implementatiemap. Dashboards publiceren vanuit deze map. Verwijder edit+ access en beperk updates voor Git. Dashboards delen met consumenten.	Consumenten hebben toegang tot een consistente, gepubliceerde versie van het dashboard. Dashboards in dezelfde map kunnen worden gedeeld met verschillende doelgroepen.	Geen ingebouwde ondersteuning voor het synchroniseren van een externe branch met een Git-map in de werkruimte of het uitrollen van Databricks Asset Bundles met een dashboardresources van een externe locatie. CI/CD-automatisering instellen om het volgende te automatiseren: Updates ophalen uit de externe opslagplaats. Dashboards publiceren na synchronisatie. Databricks Asset Bundles implementeren na een update.

Zie Samenwerken met Git-mappen voor meer aanbevolen procedures voor samenwerking in Databricks Git-mappen.

Beperkingen

Houd rekening met de volgende beperkingen bij het gebruik van broncodebeheer met AI/BI-dashboards:

• Er kunnen maximaal 100 dashboards gecommit worden binnen een enkele Git-map. Deze limiet kan worden gewijzigd tijdens de openbare preview-periode.
• Git-taken, zoals taken die verwijzen naar Git-URL's in plaats van werkruimteasset-id's of paden, worden niet ondersteund.
• Dashboardserialisatie genereert lange tekenreeksen, waardoor het lezen en controleren van verschillen tijdens pull-aanvragen moeilijk is.
• De bestandsindeling van het dashboard wordt periodiek gewijzigd om nieuwe velden en andere verbeteringen toe te voegen. Tijdens de openbare preview-periode kunnen deze wijzigingen worden weergegeven als verschillen in Git die niet zijn gerelateerd aan door de gebruiker geïnitieerde bewerkingen.