Klonen eines Legacy-Dashboards zu einem Lakeview-Dashboard

Hinweis

Dashboards (früher Lakeview-Dashboards) sind jetzt allgemein verfügbar.

Dashboards sind in Azure Government-Regionen nicht verfügbar. Verwenden Sie Legacy-Dashboards.

• Azure Databricks empfiehlt die Erstellung neuer Dashboards mithilfe der neuesten Tools. Siehe Dashboards.
• Ursprüngliche Databricks-SQL-Dashboards werden jetzt als Legacy-Dashboards bezeichnet. Sie werden weiterhin unterstützt und mit der Behebung kritischer Fehler aktualisiert, aber neue Funktionen sind eingeschränkt. Sie können weiterhin Legacy-Dashboards sowohl für die Erstellung als auch für den Verbrauch verwenden.
• 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 Lakeview-Dashboard. Tutorials zum Erstellen und Verwalten von Dashboards mithilfe der REST-API finden Sie unter Verwenden von Azure Databricks-APIs zum Verwalten von Dashboards.

In diesem Artikel wird beschrieben, wie Sie ein neues Entwurfsdashboard erstellen, indem Sie ein vorhandenes Legacy-Dashboard klonen. Zu Lakeview-Dashboard klonen ist eine Menüoption in der Benutzeroberfläche, die den Konvertierungsprozess vereinfacht.

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

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 Upstream-Abfragen verfügen, einschließlich derjenigen, die abfragebasierte Dropdown-Listenparameter 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 zum Dashboard

Die folgende Animation zeigt eine erfolgreiche Konvertierung.

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

1. Klicken Sie auf Klonen zum Lakeview-Dashboard.

   Sie können über die folgenden Bereiche der Benutzeroberfläche auf die -Option „Klonen zum Lakeview Dashboard“ zugreifen:

   • Der Arbeitsbereichsdateibrowser.

     Klicken Sie mit der rechten Maustaste auf den Dashboardtitel und klicken Sie dann auf Klonen zum Lakeview-Dashboard. Verwenden Sie alternativ das - Kebab-Menü, um auf dieselbe Option zuzugreifen.

     

   • Ein vorhandenes Legacy-Dashboard.

     Klicken Sie im Kebab-Menü eines bestehenden Legacy-Dashboards auf Zum Lakeview-Dashboard klonen.

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 (Lakeview) 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.

   

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. Aktualisierungen des einen Dashboards haben keine Auswirkungen auf das andere.

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 Dashboard-ACLs.

Anpassen von Legacyparametern

Dashboards (ehemals Lakeview-Dashboards) bieten eingeschränkte Unterstützung für Parameter. Filter pro Widget-Parameter werden nicht unterstützt. Die folgenden Parameter werden nicht unterstützt:

• Dropdownlisten
• Abfragebasierte Dropdownlisten
• 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. Weitere Informationen finden Sie unter [_] (/sql/language-manual/sql-ref-parameter-marker. md # named-parameter-markers). 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.

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

Dashboards (früher Lakeview-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. Weitere Informationen dazu, welche Visualisierungen und Filter unterstützt werden, finden Sie unter Hinzufügen oder Entfernen von Visualisierungs-, Text- und Filterwidgets auf der Canvas.

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