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.

GIF mit Konvertierungsprozess

Führen Sie die folgenden Schritte aus, um ein Dashboard zu klonen:

  1. 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ü Kebab-Menü, um auf dieselbe Option zuzugreifen.

    • Ein Legacy-Dashboard.

      • Bei der Anzeige eines gespeicherten Dashboards: Klicken Sie im OptionsmenüKebab-Menü 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ü Kebab-Menü und klonen Sie dann mit KI/BI.
  2. (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.

  3. Klicken Sie auf Klonen.

    Erfolgsmeldung mit Link zum neuen Dashboard.

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.

Eine neu konvertierte Datasetabfrage mit Parametern in der Syntax mit geschweiften Klammern und einer Warnmeldung

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.

Dashboard einschließlich Widgets mit Fehlern.

Unter -Dashboard-Visualisierungstypen erfahren Sie, wie Sie die in Dashboards unterstützten Diagrammtypen verwenden können.