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.

Übersicht

Dieses Feature befindet sich in der Public Preview.

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.

Alternative: Manuelle Versionssteuerung

Wenn Sie die öffentliche Vorschau nicht aktivieren können, verwenden Sie den folgenden manuellen Workflow, um Dashboardversionen nachzuverfolgen:

1. Exportieren Sie Ihr Dashboard als JSON-Datei. Das Dateiformat ist lvdash.json. Informationen zum Exportieren, Importieren oder Ersetzen eines Dashboards finden Sie unter Exportieren, Importieren oder Ersetzen eines Dashboards .
2. Fügen Sie diese Datei zu einem Versionskontrollsystem hinzu, z. B. Git.
3. Bearbeiten Sie die Datei. Sie können Werte in der Textdatei direkt bearbeiten oder in Ihren Arbeitsbereich hochladen und Änderungen in der Benutzeroberfläche vornehmen.
4. Speichern Sie die neue Datei. Wenn Sie Änderungen an der Benutzeroberfläche vorgenommen haben, exportieren Sie Ihre neue Datei. Verwenden Sie Ihr Versionskontrollsystem, um Dashboardänderungen und -versionen nachzuverfolgen.
5. Aktualisieren Sie das vorhandene Dashboard. Gehen Sie im vorhandenen Entwurfsdashboard wie folgt vor:
   1. Klicken Sie auf das in der oberen rechten Ecke und klicken Sie dann auf "Dashboard ersetzen".
   2. Wählen Sie im Dialogfeld Dashboard aus Datei ersetzen die Option Datei auswählen aus. Klicken Sie dann auf Überschreiben.

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.

Empfohlener Entwicklungsworkflow

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.

Von Bedeutung

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".

Einschränkungen

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.