Clonare un dashboard legacy in un dashboard lakeview

Nota

I dashboard (in precedenza i dashboard lakeview) sono ora disponibili a livello generale.

I dashboard non sono disponibili nelle aree Azure per enti pubblici. Usare i dashboard legacy.

• Azure Databricks consiglia di creare nuovi dashboard usando gli strumenti più recenti. Vedere Dashboard.
• I dashboard SQL originali di Databricks sono ora denominati dashboard legacy. Continueranno a essere supportati e aggiornati con correzioni di bug critiche, ma le nuove funzionalità saranno limitate. È possibile continuare a usare i dashboard legacy sia per la creazione che per l'utilizzo.
• Convertire i dashboard legacy usando lo strumento di migrazione o l'API REST. Per istruzioni sull'uso dello strumento di migrazione predefinito, vedere Clonare un dashboard legacy in un dashboard di Lakeview. Vedere Usare le API di Azure Databricks per gestire i dashboard per esercitazioni sulla creazione e la gestione dei dashboard tramite l'API REST.

Questo articolo descrive come creare un nuovo dashboard bozza clonando un dashboard legacy esistente. Clonare nel dashboard di Lakeview è un'opzione di menu nell'interfaccia utente che semplifica il processo di conversione.

L'uso di questo pulsante per creare un nuovo dashboard non influisce sul dashboard o sulle query legacy originali. Questo processo usa invece le query sottostanti e le impostazioni del widget per creare un dashboard equivalente.

Nota

I dashboard (in precedenza i dashboard lakeview) non supportano tutte le funzionalità del dashboard legacy. Per informazioni sulle funzionalità disponibili, vedere Dashboard .

Autorizzazioni necessarie

È necessario disporre almeno dell'autorizzazione Can View per il dashboard legacy e per tutte le query upstream, inclusi i parametri dell'elenco a discesa basato su query. I dashboard legacy gestiscono le autorizzazioni per query e dashboard SQL di Databricks separatamente. Autorizzazioni insufficienti per una query upstream causa l'esito negativo dell'operazione di clonazione.

Clonare nel dashboard

L'animazione seguente mostra una conversione riuscita.

Completare i passaggi seguenti per clonare un dashboard:

1. Fare clic su Clona nel dashboard di Lakeview.

   È possibile accedere all'opzione Clone to Lakeview dashboard (Clona in Lakeview) dalle aree seguenti nell'interfaccia utente:

   • Browser file dell'area di lavoro.

     Fare clic con il pulsante destro del mouse sul titolo del dashboard, quindi scegliere Clona nel dashboard di Lakeview. In alternativa, usare il menu kebab per accedere alla stessa opzione.

   • Un dashboard legacy.

     • Quando si visualizza un dashboard salvato: fare clic su Clona nel dashboard di Lakeview dal menu kebab in un dashboard legacy esistente.

     • Quando si modifica un dashboard salvato: fare clic su Clone to Lakeview (Clona in Lakeview ) nell'angolo superiore destro della schermata.

       

2. (Facoltativo) Specificare un titolo e un percorso della cartella per il nuovo dashboard.

   Per impostazione predefinita, si salva il nuovo dashboard nella stessa cartella del dashboard legacy originale, con (Lakeview) aggiunto al titolo originale. In questa fase è possibile ritirare il nuovo dashboard e scegliere una cartella di destinazione diversa.

3. Fare clic su Clona.

   

Al termine dell'operazione, cercare una notifica nell'angolo superiore destro dello schermo. Usare il collegamento per passare al nuovo dashboard.

Esaminare i risultati del dashboard clonato

Un'operazione di clonazione riuscita crea un nuovo dashboard bozza. Il dashboard legacy esistente e le query correlate rimangono invariati. I due dashboard non sono correlati. Aggiornamenti a un dashboard non influiscono sull'altro.

Il nuovo dashboard viene creato come bozza. Eredita tutte le autorizzazioni di condivisione applicate a livello di cartella. Le autorizzazioni impostate nel dashboard di origine non vengono propagate.

A tutte le bozze del dashboard vengono concesse automaticamente le credenziali Run as Viewer , indipendentemente dalle impostazioni delle credenziali esistenti nel dashboard legacy originale. Quando si pubblica un dashboard, è possibile scegliere di incorporare o meno le credenziali. Ciò influisce sul modo in cui gli altri utenti visualizzano e interagiscono con il dashboard. Vedere Elenchi di controllo di accesso al dashboard per informazioni su come condividere e gestire le autorizzazioni per i dashboard pubblicati.

Modificare i parametri legacy

I dashboard (in precedenza i dashboard di Lakeview) offrono un supporto limitato per i parametri. I filtri dei parametri per widget non sono supportati. I tipi di parametro seguenti non sono supportati:

• Elenchi a discesa
• Elenchi a discesa basati su query
• Intervallo di date

Tutti i tipi di parametri supportati vengono mantenuti nel nuovo dashboard. Per impostazione predefinita, i tipi di parametri non supportati sono string valori. I valori predefiniti impostati in precedenza vengono mantenuti.

Usare i widget dei parametri

Durante l'operazione di clonazione, tutti i widget dei parametri legacy a livello di dashboard vengono convertiti in filtri e vengono visualizzati nella parte superiore del nuovo canvas del dashboard. I widget dei parametri di data e ora vengono aggiunti come filtri selezione data e tutti gli altri tipi di widget di parametri vengono convertiti in filtri a valore singolo.

Quando si clona un dashboard che include query con parametri, il clone riesce a ricreare la query di destinazione, ma la query deve essere modificata in modo da usare la sintassi dei parametri denominata per l'esito positivo. Vedere [_] (/sql/language-manual/sql-ref-parameter-marker. md # named-parameter-markers). È necessario aggiornare la sintassi nella query del set di dati correlata per cancellare il messaggio di errore visualizzato nel widget del filtro dei parametri. Fare clic con il pulsante destro del mouse sul widget per aprire e modificare la query del set di dati connesso.

Usare i parametri nei set di dati

Nella scheda Dati aprire il set di dati da modificare. Durante la conversione, tutti i parametri mustache ({{ }}) dalle query usate nei dashboard legacy vengono aggiunti automaticamente alla raccolta di parametri visualizzati nell'interfaccia utente.

Risoluzione dei problemi e regolazioni manuali

I dashboard (in precedenza i dashboard lakeview) non supportano tutte le funzionalità o i tipi di grafico disponibili nei dashboard legacy. Quando si clona un dashboard legacy con elementi non supportati, i widget nel nuovo dashboard mostrano un messaggio di errore anziché una copia del widget originale. In genere, si verificano errori durante la conversione di visualizzazioni o filtri non supportati. Per informazioni su quali visualizzazioni e filtri sono supportati, vedere Aggiungere o rimuovere visualizzazioni, testo e widget di filtro nell'area di disegno .

Vedere Tipi di visualizzazione dashboard per informazioni su come usare i tipi di grafico supportati nei dashboard.