Freigeben über

Versionssteuerungs-Dashboards mit Git

Auf dieser Seite wird erläutert, wie Sie Git-Ordner von Databricks für die Versionssteuerung und die Entwicklung von Dashboards für die Zusammenarbeit verwenden. Außerdem wird beschrieben, wie CI/CD-Prozesse implementiert werden, um Dashboards in verschiedenen Arbeitsbereichen zu entwickeln und bereitzustellen.

Wichtig

Dieses Feature befindet sich in der Public Preview.

Überblick

Git-Ordner von Databricks verfolgen Dashboardänderungen und -verlauf, unterstützen die Zusammenarbeit im Team und ermöglichen Ihnen die Bereitstellung von Dashboards in der Produktion und Wiederherstellung früherer Versionen.

Dashboard-Quellcodeverwaltung aktivieren

Arbeitsbereichsadministratoren können den Arbeitsbereichzugriff auf die öffentliche Vorschau über die Vorschauseite steuern. Die Vorschau für Support-Dashboards in der Git-Ordnern ist standardmäßig aktiviert.

Funktionsweise der Git-Integration mit Dashboards

Git-Ordner von Databricks verfolgen und verwalten Änderungen an Dashboards im Entwurfsstatus. Der Dashboardentwurf spiegelt alle Änderungen in einem verfolgten Dashboard wider. Git verfolgt keine Veröffentlichungs- und Terminplanungskonfigurationen, z. B. die Lagerauswahl und die Erstellung von Terminplänen. Um diese Konfigurationen zu verwalten, verwenden Sie die Benutzeroberfläche oder automatisieren Sie Änderungen mit Databricks Asset Bundles oder der AI/BI REST-API.

  • Informationen zur Verwendung von Bündeln für die Dashboardverwaltung finden Sie unter Dashboard.
  • Informationen zum Veröffentlichen und Planen von Dashboards mit der REST-API finden Sie in der Lakeview-API-Referenz.

Hinweis

Die Lakeview-API verwendet den vorherigen Namen für AI/BI-Dashboards.

Git-Ordner von Databricks verwalten allgemeine Git-Vorgänge für Dashboards und andere Arbeitsbereichsobjekte. Weitere Informationen finden Sie unter Azure Databricks Git-Ordner.

Anwenden der Quellcodeverwaltung auf Dashboards

Um Dashboards mit Git nachzuverfolgen, platzieren Sie sie in einem Git-Ordner "Databricks". Verwenden Sie eine der folgenden Optionen:

  • Neue Dashboards: Erstellen Sie Ihr Dashboard in einem vorhandenen Git-Ordner "Databricks", um die Quellcodeverwaltung von Anfang an anzuwenden.
  • Vorhandene Dashboards: Verschieben Sie ein vorhandenes Dashboard in einen Git-Ordner "Databricks", um es mit Git nachzuverfolgen.

Verwalten von Berechtigungen für quellcodegesteuerte Dashboards

Berechtigungen auf Ordnerebene gelten für alle Objekte innerhalb dieses Ordners, einschließlich Dashboards. Dashboards in einem Git-Ordner erben zusätzlich zu allen dashboardspezifischen Berechtigungen die Berechtigungen des übergeordneten Ordners. Für die meisten Git-Vorgänge ist die CAN MANAGE-Berechtigung erforderlich. Weitere Informationen finden Sie unter Ordner-ACLs und Git-Ordner-ACLs.

Klonen Sie das Repository in Ihren eigenen Git-Ordner "Databricks", verwenden Sie Featurezweige, und senden Sie Pullanforderungen. In der folgenden Tabelle wird beschrieben, wie Sie Mithilfe von Git-Ordnern Dashboards in verschiedenen Phasen der Entwicklung und Bereitstellung verwalten können.

Wichtig

Das Wechseln von Git-Verzweigungen ist ein destruktiver Vorgang für Dashboards. Azure Databricks entfernt Dashboards, die nicht im Zielzweig vorhanden sind. Wenn Sie zurückwechseln, werden Dashboards wieder mit neuen URLs und IDs angezeigt, wodurch veröffentlichte Links, Lesezeichen und API-Integrationen unterbrochen werden. Überprüfen Sie den Zielbranch, bevor Sie wechseln, und aktualisieren Sie anschließend alle Verweise.

Projektphase Arbeitsablauf Erwartetes Ergebnis Bekannte Einschränkungen
Anfänglicher Commit
  • Verschieben Sie das Dashboard in einen Git-Ordner im Arbeitsbereich.
  • Committen und Pushen in das Git-Remoterepository.
 Git verfolgt das Dashboard in einem Remote-Repository.
Entwicklung
  • Entwickler erstellen Git-Ordner in separaten Dev Branches, in der Regel in ihren Heimordnern.
  • Übertragen Sie Änderungen auf den Entwicklungsbranch.
  • Zusammenführen von Entwicklungszweigen mit dem Hauptzweig mithilfe von Pull-Requests.
  • Entwickler arbeiten unabhängig voneinander.
  • Git verfolgt Dashboardversionen nach.
 Dashboarddateien verwenden JSON das Format. SQL-Abfragen werden als einzelne Zeile angezeigt, wodurch diffs in Pull-Anforderungen schwer zu überprüfen sind.
Einsatz
  • Erstellen Sie einen Git-Ordner im Bereitstellungsbranch in einem Ordner auf oberster Ebene, der keinen Benutzenden zugeordnet ist. Siehe CI/CD mit Git-Ordnern für Databricks.
  • Ziehen Sie Änderungen in den Bereitstellungsordner.
  • Veröffentlichen Sie Dashboards aus diesem Ordner.
  • Entfernen Sie edit+ access, und beschränken Sie Updates auf Git.
  • Freigeben von Dashboards für Verbraucher.
  • Verbraucher greifen auf eine konsistente, veröffentlichte Version des Dashboards zu.
  • Sie können Dashboards im selben Ordner für verschiedene Zielgruppen freigeben.
 Databricks bietet keine integrierte Unterstützung für die Synchronisierung einer Remote-Verzweigung mit einem Git-Ordner im Arbeitsbereich oder die Bereitstellung von Databricks Asset Bundles mit einer Dashboardressource aus der Ferne. Richten Sie die CI/CD-Automatisierung ein, um folgendes zu automatisieren:
  • Abrufen von Updates aus dem Remote-Repository.
  • Veröffentlichen von Dashboards nach der Synchronisierung.
  • Bereitstellen von Databricks Asset Bundles nach einem Update.

Weitere bewährte Methoden für die Zusammenarbeit in Git-Ordnern von Databricks finden Sie unter "Zusammenarbeit mithilfe von Git-Ordnern".

Begrenzungen

Die Quellcodeverwaltung mit AI/BI-Dashboards hat die folgenden Einschränkungen:

  • Sie können maximal 100 Dashboards in einem einzigen Git-Ordner übernehmen. Dieser Grenzwert kann sich während der öffentlichen Vorschau ändern.
  • Git-basierte Aufträge, z. B. Aufträge, die auf Git-URLs verweisen, anstelle von Arbeitsbereichsobjekt-IDs oder Pfaden, funktionieren nicht mit Dashboards.
  • Die Dashboard-Serialisierung generiert lange Zeichenfolgen, wodurch das Lesen und Überprüfen von Unterschieden während Pullanforderungen schwierig wird.
  • Das Dashboarddateiformat ändert sich regelmäßig, um neue Felder und andere Verbesserungen einzuschließen. Während der öffentlichen Vorschau werden diese Änderungen möglicherweise als Unterschiede in Git angezeigt, die Sie nicht initiiert haben.
  • Last updated on