Klonen eines Legacy-Dashboards zu einem KI-/BI-Dashboard
Wichtig
- Databricks empfiehlt die Verwendung von KI/BI-Dashboards (ehemals Lakeview-Dashboards). Frühere Versionen von Dashboards, die zuvor als Databricks-SQL-Dashboards bezeichnet werden, werden jetzt als Legacy-Dashboards bezeichnet. Databricks rät davon ab, neue Legacy-Dashboards zu erstellen.
- Konvertieren Sie Legacy-Dashboards mithilfe des Migrationstools oder der REST-API. Anweisungen zur Verwendung des integrierten Migrationstools finden Sie unter Klonen eines Legacy-Dashboards in einem KI/BI-Dashboard. Tutorials zum Erstellen und Verwalten von Dashboards mithilfe der REST-API finden Sie unter Dashboard-Tutorials.
In diesem Artikel wird beschrieben, wie Sie ein neues Entwurfsdashboard erstellen, indem Sie ein vorhandenes Legacy-Dashboard klonen. Zu KI/BI-Dashboard klonen ist eine Menüoption in der Benutzeroberfläche, die den Konvertierungsprozess vereinfacht. Klonen auf KI/BIDashboard wird für Legacy-Dashboards mit maximal 100 Widgets unterstützt.
Die Verwendung dieser Schaltfläche zum Erstellen eines neuen Dashboards wirkt sich nicht auf das ursprüngliche Legacy-Dashboard oder Abfragen aus. Stattdessen verwendet dieser Prozess die zugrunde liegenden Abfragen und Widget-Einstellungen, um ein entsprechendes Dashboard zu erstellen.
Hinweis
KI/BI-Dashboards (früher Lakeview-Dashboards) unterstützen nicht alle Legacy-Dashboardfunktionen. Informationen zu den verfügbaren Features finden Sie unter Dashboards.
Erforderliche Berechtigungen
Sie müssen mindestens über die Berechtigung KANN ANZEIGEN im Legacy-Dashboard und allen Upstreamabfragen verfügen, einschließlich derjenigen, die abfragebasierte Dropdownlisten-Parameter unterstützen. Legacy-Dashboards behandeln Berechtigungen für SQL-Abfragen und Dashboards von Databricks separat. Unzureichende Berechtigungen für eine Upstream-Abfrage führen dazu, dass der Klonvorgang fehlschlägt.
Klonen zu KI/BI-Dashboard
Die folgende Animation zeigt eine erfolgreiche Konvertierung.
Führen Sie die folgenden Schritte aus, um ein Dashboard zu klonen:
Klicken Sie auf Zum KI/BI-Dashboard klonen.
Sie können über die folgenden Bereiche der Benutzeroberfläche auf die Option Clone to AI/BI dashboard (Zum KI/BI-Dashboard klonen) zugreifen:
Der Arbeitsbereichsdateibrowser.
Klicken Sie mit der rechten Maustaste auf den Dashboardtitel und klicken Sie dann auf Klonen zum KI/BI-Dashboard. Verwenden Sie alternativ das Kebab-Menü , um auf dieselbe Option zuzugreifen.
Ein Legacy-Dashboard.
- Bei der Anzeige eines gespeicherten Dashboards: Klicken Sie im Optionsmenü eines bestehenden Legacy-Dashboards auf Clone to AI/BI dashboard (Zum KI/BI-Dashboard klonen).
- Wenn Sie ein gespeichertes Dashboard bearbeiten: Klicken Sie auf das Kebab-Menü und klonen Sie dann mit KI/BI.
(Optional) Geben Sie einen Titel und einen Ordnerspeicherort für das neue Dashboard an.
Standardmäßig speichern Sie das neue Dashboard im selben Ordner wie das ursprüngliche Legacy-Dashboard, wobei (KI/BI) an den ursprünglichen Titel angefügt ist. In dieser Phase können Sie das neue Dashboard zurücksetzen und einen anderen Zielordner auswählen.
Klicken Sie auf Klonen.
Suchen Sie nach Abschluss des Vorgangs in der oberen rechten Ecke des Bildschirms nach einer Benachrichtigung. Verwenden Sie den Link, um zu Ihrem neuen Dashboard zu navigieren.
Überprüfen der geklonten Dashboardergebnisse
Ein erfolgreicher Klonvorgang erstellt ein neues Entwurf-Dashboard. Das vorhandene Legacy-Dashboard und verwandte Abfragen bleiben unverändert. Die beiden Dashboards sind nicht miteinander verknüpft, und Aktualisierungen in einem wirken sich nicht auf das andere aus.
Das neue Dashboard wird als Entwurf erstellt. Es erbt alle Freigabeberechtigungen, die auf Ordnerebene gelten. Die auf dem Quell-Dashboard festgelegten Berechtigungen werden nicht übertragen.
Allen Dashboard-Entwürfen werden automatisch Als Viewer-Anmeldeinformationen ausführen zugewiesen, unabhängig von den bestehenden Anmeldeinformationen im ursprünglichen Legacy-Dashboard. Wenn Sie ein Dashboard veröffentlichen, können Sie wählen, ob Sie Anmeldedaten einbetten möchten oder nicht. Dies wirkt sich darauf aus, wie andere Benutzer Ihr Dashboard sehen und damit interagieren. Informationen zum Freigeben und Verwalten von Berechtigungen für veröffentlichte Dashboards finden Sie unter KI/BI-Dashboard-ACLs.
Anpassen von Legacyparametern
KI/BI-Dashboards bieten eingeschränkte Unterstützung für Parameter. Die folgenden Parameter werden nicht unterstützt:
- Dropdownliste mit mehreren Werten
- Datumsbereich
Alle unterstützten Parametertypen bleiben im neuen Dashboard enthalten. Für nicht unterstützte Parametertypen wird als Standardwert string
verwendet. Zuvor festgelegte Standardwerte werden beibehalten.
Verwenden von Parameterwidgets
Während des Klonvorgangs werden alle Parameterwidgets auf Ebene des Legacy-Dashboards in Filter konvertiert und oben auf der Canvas des neuen Dashboards angezeigt. Parameter-Widgets für Datum und Uhrzeit werden als Filter vom Typ Datumsauswahl hinzugefügt, und alle anderen Typen von Parameterwidgets werden in Einzelwertfilter konvertiert.
Wenn Sie ein Dashboard klonen, das Abfragen mit Parametern enthält, kann der Klon erfolgreich die Zielabfrage neu erstellen, aber die Abfrage muss angepasst werden, um die Syntax für benannte Parameter erfolgreich zu verwenden. Sie müssen die Syntax in der zugehörigen Datasetabfrage aktualisieren, um die Fehlermeldung zu beseitigen, die im Parameterfilterwidget angezeigt wird. Klicken Sie mit der rechten Maustaste auf das Widget, um die verknüpfte Datasetabfrage zu öffnen und zu bearbeiten. Siehe Arbeiten mit Abfrageparametern für Syntax und Beispiele.
Verwenden von Parametern in Datasets
Öffnen Sie auf der Registerkarte Daten das Dataset, das Sie bearbeiten möchten. Bei der Konvertierung werden alle Parameter in geschweiften Klammern ({{ }}
) aus Abfragen, die in älteren Dashboards verwendet wurden, automatisch der Auflistung von Parametern hinzugefügt, die auf der Benutzeroberfläche angezeigt werden.
Problembehandlung und manuelle Anpassungen
KI/BI-Dashboards unterstützen nicht alle Features oder Diagrammtypen, die in Legacy-Dashboards verfügbar sind. Wenn Sie ein Legacy-Dashboard mit nicht unterstützten Elementen klonen, zeigen Widgets auf dem neuen Dashboard eine Fehlermeldung anstelle einer Kopie des ursprünglichen Widgets an. Beim Konvertieren nicht unterstützter Visualisierungen oder Filter treten häufig Fehler auf. Siehe Hinzufügen von Seiten, Visualisierungen, Text und Filtern zum Zeichenbereich , um zu erfahren, welche Visualisierungen und Filter unterstützt werden.
Unter -Dashboard-Visualisierungstypen erfahren Sie, wie Sie die in Dashboards unterstützten Diagrammtypen verwenden können.