Dashboard legacy

È possibile usare l'editor SQL per creare un dashboard di legacy che combina visualizzazioni e caselle di testo che forniscono contesto ai dati.

Visualizzare e organizzare i dashboard legacy

È possibile accedere ai dashboard dal browser dell'area di lavoro insieme ad altri oggetti di Azure Databricks.

• Fare clic su Area di lavoro nella barra laterale per visualizzare i dashboard dal browser dell'area di lavoro. I dashboard vengono archiviati nella /Workspace/Users/<username> directory per impostazione predefinita. Gli utenti possono organizzare i dashboard in cartelle nel browser dell'area di lavoro insieme ad altri oggetti di Azure Databricks.

• Per visualizzare la pagina di presentazione del dashboard, fare clic su Dashboard nella barra laterale.

• Fare clic sulla scheda Dashboard legacy per visualizzare i dashboard legacy.

  Per impostazione predefinita, la scheda Dashboard personali è selezionata e mostra i dashboard ordinati in ordine cronologico inverso. Riordinare il list facendo clic sull'intestazione Creata in. In alternativa, usare le schede vicino alla parte superiore della pagina per visualizzare Preferiti o Tutti i dashboard. Usare la scheda Tag per filtrare in base al tag.

Organizzare i dashboard in cartelle nel visualizzatore area di lavoro

Organizzare dashboard nuovi ed esistenti in cartelle nel visualizzatore area di lavoro insieme ad altri oggetti di Azure Databricks. Vedere Visualizzatore area di lavoro.

Filtrare il list dei dashboard salvati

Filtrare il list di tutti i dashboard in base ai dashboard creati (Dashboard personali), preferitie tag.

Creare un dashboard legacy

Seguire questi passaggi per creare o un nuovo dashboard legacy. Per clonare un dashboard esistente, consultare Clonare un dashboard legacy.

1. Fare clic su Dashboard nella barra laterale, quindi sulla scheda Dashboard legacy.
2. Fare clic su Crea dashboard legacy.
3. Immettere un nome per il dashboard.
4. Quando si crea una dashboard, è possibile specificare un magazzino da usare per l'uso manuale di refresh. Se non si select e si salva un magazzino nel dashboard, si ricorrerà all'uso del magazzino salvato per le singole query.

1. Aggiungere il contenuto al dashboard facendo clic su Aggiungi e selezionando il tipo di contenuto da aggiungere:

   • Fare clic su Casella di testo per aggiungere commenti.

     Immettere il testo. Applicare uno stile alle caselle di testo usando Markdown.

     • Per aggiungere un'immagine statica in una casella di testo, usare la sintassi dell'immagine markdown con una descrizione e un URL disponibile pubblicamente: ![description](url). Ad esempio, il seguente markdown inserisce un'immagine del logo di Databricks: ![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png). Per ridimensionare l'immagine, ridimensionare le dimensioni del widget.
     • Per aggiungere un'immagine da DBFS, aggiungere la sintassi dell'immagine markdown con una descrizione desiderata e un percorso FileStore: ![description](files/path_to_dbfs_image). Per ridimensionare l'immagine, ridimensionare le dimensioni del widget.

     Importante

     Per le immagini usate in un dashboard archiviate in DBFS, non verrà eseguito il rendering in caso di un pdf o sottoscrizione su richiesta

   • Fare clic su Visualizzazione per aggiungere una visualizzazione query.

     1. Select una query. Eseguire una ricerca nelle query esistenti o selezionarne una recente nel listprecompilato. Se una query è stata salvata con l'impostazione di Limit 1000, la query nel dashboard limita i risultati a 1000 righe.

     2. Nell'elenco a discesa Scegli visualizzazione, select il tipo di visualizzazione.

        

2. Fare clic su Aggiungi al dashboard legacy.

3. Trascinare la selezione dei blocchi di contenuto nel dashboard.

4. Fare clic su Modifica completata.

   

È anche possibile creare un dashboard con il provider Databricks Terraform e databricks_sql_dashboard. È possibile creare un widget per un dashboard legacy con databricks_sql_widget. È possibile creare un dashboard legacy di esempio con dbsql-nyc-taxi-trip-analysis.

Clonare un dashboard legacy

È possibile clonare il dashboard legacy e tutte le query upstream se si dispone delle autorizzazioni CAN RUN, CAN EDIT e CAN MANAGE nel dashboard e in ciascuna delle relative query upstream. Si diventa il proprietario del nuovo dashboard e delle query.

Per clonare un dashboard legacy:

1. Aprire il menu kebab menu kebab in alto a destra del dashboard e selectClonare.
2. Immettere un nome per il nuovo dashboard, quindi fare clic su Conferma.

Per ulteriori dettagli sul menu a tendina basato su query listparameters, consultare il menu a tendina Query-Based List.

Uso della query parameters nei quadri di controllo legacy

Le query possono facoltativamente sfruttare parameters o valuesstatici. Quando una visualizzazione basata su una query con parametri viene aggiunta a un dashboard, la visualizzazione può essere configurata per l'uso di:

• parametro widget: i parameters widget sono specifici di una singola visualizzazione all'interno di un dashboard, vengono visualizzati all'interno del pannello di visualizzazione e il parametro values specificato si applica solo alla query sottostante la visualizzazione.
• parametro dashboard: il Dashboard legacy parameters può essere applicato a più visualizzazioni. Quando si aggiunge a un dashboard una visualizzazione basata su una query con parametri, per impostazione predefinita il parametro verrà conteggiato come un parametro del dashboard. I dashboard parameters sono configurati per una o più visualizzazioni all'interno di un dashboard e vengono visualizzati nella parte superiore del dashboard. Il parametro values specificato per un parametro del dashboard si applica alle visualizzazioni riutilizzando quel particolare parametro del dashboard. Una dashboard può avere più parameters, ognuno dei quali può essere applicato ad alcune visualizzazioni e non ad altre.
• valore statico: vengono usati values statici anziché un parametro che risponde alle modifiche. Le values statiche consentono di inserire in modo fisso un valore al posto di un parametro e il "parametro" scompare dal dashboard o dal widget where in cui appariva precedentemente.

Quando si aggiunge una visualizzazione contenente una query con parametri, è possibile scegliere il titolo e l'origine per il parametro nella query di visualizzazione facendo clic sull'icona appropriata a forma di matita . È anche possibile utilizzare select per la parola chiave e un valore predefinito. Vedere Proprietà parametri.

Dopo aver aggiunto una visualizzazione a un dashboard, è possibile accedere all'interfaccia di mapping dei parametri facendo clic sul menu con i puntini verticali in alto a destra di un widget del dashboard e quindi scegliendo Modifica impostazioni widget.

Proprietà dei parametri

Le proprietà dei parametri del widget del dashboard sono:

• Titolo: nome visualizzato accanto al selettore di valori nel dashboard. Per impostazione predefinita, viene utilizzato il titolo set nell'editor di query. Per modificare la modalità di visualizzazione all'interno del dashboard, fare clic sull'icona a forma di matita . I titoli non vengono visualizzati per il dashboard statico parameters perché il selettore di valori è nascosto. Se imposti selectValore statico come origine del valore, il campo Titolo è disattivato.

• Parola chiave: il valore letterale stringa per questo parametro nella query sottostante. Ciò è utile per il debug se il dashboard non restituisce i risultati previsti.

• valore predefinito: il valore set per quel parametro viene utilizzato durante il caricamento del dashboard, finché non se ne seleziona un altro e vengono applicate le modifiche. Per modificare questo valore predefinito, aprire la query sottostante nell'editor SQL, modificare il parametro sul valore desiderato e fare clic sul pulsante Salva.

• Origine del valore: l’origine del valore del parametro. Fare clic sull'icona a forma di matita per scegliere un'origine.

  • Nuovo parametro del dashboard: creare un nuovo parametro a livello di dashboard. In questo modo è possibile set un valore di parametro in un'unica posizione nel dashboard e associarlo a una o più visualizzazioni. Parameters deve avere nomi univoci all'interno della dashboard.
  • Parametro dashboard esistente: eseguire il mapping del parametro di questa visualizzazione a un parametro del dashboard esistente. È necessario specificare il parametro del dashboard preesistente.
  • Parametro del widget: mostra un selettore di valori all'interno del widget del dashboard. Ciò è utile per parameters una tantum che non sono condivise tra i widget.
  • valore statico: scegliere un valore statico per il widget, indipendentemente dal values usato in altri widget. Il parametro mappato in modo statico values non visualizza un selettore di valori in nessun punto del dashboard, rendendo l'interfaccia più compatta. In questo modo è possibile sfruttare la flessibilità delle query parameters senza appesantire l'interfaccia utente in un dashboard quando alcuni parameters non si prevede cambieranno spesso.

  

Modificare un dashboard legacy

Per modificare il dashboard, apri il menu kebab in alto a destra del dashboard e selectModifica.

Durante la modifica, è possibile aggiungere e remove contenuto, modificare le visualizzazioni e applicare filtri. Per modificare l'ordine in cui vengono visualizzati parameters, è possibile fare clic e trascinare ogni parametro nella posizione desiderata.

Filtrare più query

Per filtrare più query in un dashboard:

1. Passare al dashboard legacy.
2. In modalità Modifica, fare clic su Aggiungi e quindi su Filtro.
3. Select Nuovo filtro dashboard e scegliete le query e columns per il filtro. È anche possibile scegliere di importare filtri da query esistenti selezionando Filtri di query esistenti e scegliendo di importare un filtro da un editor di query SQL. Le query scelte devono appartenere alle stesse categorie catalog e schema.
4. Fare clic su Salva. Verrà creato un filtro che contiene l'unione di tutte le opzioni a discesa.

Modificare una visualizzazione dashboard

Per modificare una visualizzazione nel dashboard in modalità di modifica, select la visualizzazione da modificare e quindi fare clic sul menu menu kebab in alto a destra della visualizzazione. Nella listvisualizzata selectModifica visualizzazione.

Aggiungere contenuti a un dashboard

1. Aprire il dashboard per la modifica.
2. Fare clic su Aggiungi casella di testo o Aggiungi widget.
3. Fare clic su Aggiungi al dashboard legacy.
4. Fare clic su Modifica completata.

È anche possibile aggiungere una visualizzazione a un dashboard nell'editor SQL.

Remove contenuto da un dashboard

1. Fare clic sull'icona di eliminazione SQL o passare il puntatore del mouse sull'oggetto, fare clic sul menu kebab nell'angolo in alto a destra del widget e selectRemove da Dashboard.
2. Fai clic su Elimina.

Filtri del dashboard

Quando le query hanno filtri, è necessario applicare anche filtri a livello di dashboard. Select Usa la casella di controllo Filtri a livello della dashboard per applicare il filtro a tutte le query.

Personalizzare i colori del dashboard

È possibile personalizzare la tavolozza dei colori del dashboard e anche crearne una.

Creare una tavolozza dei colori

Per creare una tavolozza dei colori personalizzata per un dashboard:

1. Fare clic sul menu con i puntini verticali in alto a destra e fare clic su Modifica.
2. Fare clic su Colori.
3. Per importare una tavolozza dei colori esistente, fare clic su Importa e select la tavolozza. È possibile personalizzare la tavolozza importata.
4. Per creare una nuova tavolozza o per personalizzarne una importata, seguire questa procedura:
   1. Per aggiungere un nuovo colore, fare clic su Aggiungi.
   2. Per un colore appena aggiunto o uno esistente, specificare il colore eseguendo una delle operazioni seguenti:
      • Fare clic sul quadrato e select il nuovo colore facendo clic su di esso nel selettore di colori o usando il contagocce.
      • Fare clic sul campo di testo accanto al quadrato e immettere un valore esadecimale.
5. Fare clic su Applica.

Interrompere l'uso di una tavolozza dei colori personalizzata

Per remove una tavolozza dei colori personalizzata:

1. Fare clic sul menu con i puntini verticali in alto a destra e fare clic su Modifica.
2. Fare clic su Colori.
3. Fare clic su Cancella.
4. Fare clic su Applica.

Usare una tavolozza dei colori diversa per una visualizzazione

Per impostazione predefinita, se una tavolozza dei colori è stata applicata in un dashboard, tutte le visualizzazioni la useranno. Per usare colori diversi per una visualizzazione, è possibile sostituire questo comportamento:

1. Fare clic sul menu con i puntini verticali per la visualizzazione nel dashboard e fare clic su Modifica.
2. Fare clic sulla casella di controllo accanto a Mantieni i colori specificati nella visualizzazione.
3. Fare clic su OK.

Refresh un dashboard

I dashboard legacy sono progettati per un caricamento efficiente durante il recupero dei dati da una cache che si rinnova ogni volta che viene eseguita una query. Tuttavia, i dashboard possono diventare obsoleti se non si eseguono regolarmente le query associate. Per evitare che i dashboard diventino obsoleti, è possibile refresh il dashboard per rieseguire le query associate.

Ogni volta che un dashboard viene aggiornato, manualmente o in base a un programma, tutte le query a cui viene fatto riferimento nel dashboard vengono aggiornate. Quando viene aggiornata una singola visualizzazione, la query upstream viene aggiornata. L'aggiornamento manuale del dashboard o della singola visualizzazione non refresh query usate negli elenchi a discesa basati su query. Per informazioni dettagliate sugli elenchi a discesa basati su query, vedere Query-Based elenco a discesa List.

Refresh comportamento e contesto di esecuzione

Quando un dashboard è "Run as Owner" (Esegui come utente) e viene aggiunto un programma, la credenziale del proprietario viene usata per l'esecuzione e chiunque abbia almeno l'autorizzazione CAN RUN visualizza i risultati di tali query aggiornate.

Quando un dashboard è "Run as Viewer" e viene aggiunta una pianificazione, la credenziale del proprietario viene usata per l'esecuzione, ma solo il proprietario visualizza i risultati delle query aggiornate; tutti gli altri visualizzatori devono refresh manualmente per visualizzare i risultati delle query aggiornati.

refresh manualmente un dashboard

Per forzare un refresh, fare clic su Refresh nell'angolo in alto a destra del cruscotto. In questo modo tutte le query del dashboard vengono eseguite e le visualizzazioni vengono aggiornate.

Automaticamente refresh un cruscotto

Il proprietario e gli utenti di un dashboard con l'autorizzazione CAN EDIT possono configurare un dashboard per refresh automaticamente in base a una pianificazione. Per refresh un dashboard automaticamente:

1. Fare clic su Programma nell'angolo in alto a destra del dashboard. Fare clic su Aggiungi programma.

2. Usare le selezioni a discesa per specificare la frequenza, il periodo, l'orario di inizio e il fuso orario. Facoltativamente, casella di controllo Mostra sintassi cron per modificare la pianificazione in sintassi Cron.

3. Per visualizzare le impostazioni facoltative, scegliere Più opzioni. È possibile scegliere:

   • Un nome per il programma.
   • Un magazzino SQL per avviare la query. Per impostazione predefinita, il magazzino SQL usato per l'esecuzione di query ad hoc viene usato anche per un lavoro programmato. Utilizzare questa impostazione facoltativa per select un magazzino diverso per eseguire la query pianificata.

   Nota

   Il magazzino può essere diverso da quello usato per il manuale refresh.

4. Facoltativo: nella scheda Abbonati, immettere un list di indirizzi di posta elettronica per notificare quando il dashboard viene aggiornato automaticamente. Ogni indirizzo email deve essere associato a un account Azure Databricks con accesso all'area di lavoro o deve essere definito come destinazione delle notifiche nelle impostazioni dell'area di lavoro. Le destinazioni delle notifiche vengono configurate da un amministratore dell'area di lavoro.

5. Cliccare su Crea. L'etichetta Programma viene modificata in Programma(1).

6. Modificare le impostazioni di condivisione.

   Nota

   Le autorizzazioni del dashboard non sono collegate alle autorizzazioni di pianificazione. Dopo aver creato l'intervallo di refresh pianificato, aggiornare le autorizzazioni di pianificazione per fornire l'accesso ad altri utenti. Solo gli utenti con autorizzazione CAN MANAGE possono modificare la pianificazione o modificare il sottoscrittore list.

   • Fare clic sul menu con i puntini verticali .
   • Fare clic su Modifica autorizzazioni di pianificazione.
   • Scegliere un utente o un gruppo dal menu a discesa nella finestra di dialogo.
   • Scegliere CAN VIEW per consentire agli utenti selezionati di visualizzare la configurazione della pianificazione.

L'autorizzazione CAN VIEW o CAN RUN consente al destinatario assegnato di verificare l’esistenza di una pianificazione, nonché di altre proprietà come la frequenza del report e il numero di iscritti. CAN MANAGE consente al destinatario di modificare la pianificazione, il numero di sottoscrizione liste i permessi di pianificazione. L'autorizzazione CAN MANAGE consente anche al destinatario di mettere in pausa o di riprendere la pianificazione.

Comportamento di Refresh in una dashboard aperta

Quando si apre un cruscotto da set a Run as Owner, vengono visualizzati i dati dal cruscotto più recente update, indipendentemente dal fatto che sia stato pianificato o aggiornato manualmente. Se un dashboard è aperto in un browser windowe una query viene modificata o un'esecuzione pianificata aggiorna i risultati del dashboard, le modifiche non si rifletteranno immediatamente. I risultati aggiornati verranno visualizzati alla successiva apertura del cruscotto o quando il browser aperto windowè attivo refresh.

Sottoscrizioni snapshot del dashboard

È possibile esportare periodicamente e inviare snapshot del dashboard tramite email. Gli snapshot del dashboard vengono acquisiti dallo stato predefinito del dashboard: ciò significa le interazioni con filtri e visualizzazioni non sono incluse nello snapshot.

Se disponete almeno dell'autorizzazione "CAN EDIT", potete creare una pianificazione refresh nonché iscrivere gli utenti, che riceveranno istantanee via email del dashboard ogni volta che viene aggiornato. Per aggiungere gli iscritti, immettere utenti o gruppi nella scheda Iscritti, come indicato in precedenza. Gli iscritti idonei includono utenti dell'area di lavoro e destinazioni delle notifiche.

È disponibile una dimensione di 6 MB di file limit per gli allegati di posta elettronica. Se un messaggio di posta elettronica di sottoscrizione del dashboard supera le dimensioni di 6 MB limit, il messaggio di posta elettronica ometterà lo snapshot del dashboard inline e includerà solo un PDF dello snapshot del dashboard.

Se il file di snapshot PDF supera i 6 MB, l’email di sottoscrizione ometterà il PDF e includerà invece un collegamento al dashboard aggiornato. L’email includerà una nota di avviso con i dettagli delle dimensioni correnti del dashboard. (Gli utenti possono testare le dimensioni dello snapshot PDF scaricando manualmente un PDF del dashboard.)

Sospendere temporaneamente gli aggiornamenti programmati del dashboard

Se un dashboard è configurato per gli aggiornamenti automatici e si dispone almeno dell'autorizzazione CAN VIEW per la pianificazione, l'etichetta nel pulsante Pianificazione legge Schedule(#), # è il numero di eventi pianificati visibili all'utente. Inoltre, se si dispone almeno dell'autorizzazione CAN MANAGE per la pianificazione, è possibile sospenderla temporaneamente. Ciò è utile per evitare di inviare aggiornamenti durante il test delle modifiche al dashboard. Per sospendere temporaneamente gli aggiornamenti pianificati del dashboard senza modificare il list degli iscritti:

1. Fare clic su Programma(#).
2. Fare clic sul menu con i puntini verticali .
3. Fare clic su Pausa.

Arrestare l'aggiornamento automatico di un dashboard

Per interrompere l'aggiornamento automatico del dashboard e delle sottoscrizioni relative a remove:

1. Fare clic su Programma(#).
2. Fare clic sul menu con i puntini verticali >Elimina.

Limiti delle dimensioni del dashboard per le sottoscrizioni

Le email di sottoscrizione del dashboard legacy includono i file seguenti con codifica base64:

• PDF: un file PDF che include il dashboard completo.
• DesktopImage: un file di immagine ottimizzato per la visualizzazione sui PC.

Alle dimensioni combinate dei due file viene imposto un massimo di limit di 6 MB. Le descrizioni seguenti descrivono il comportamento previsto quando le dimensioni combinate del file superano il limit:

• Se il file PDF supera 6 MB: l’email di sottoscrizione non include l'allegato PDF o le immagini. Include una nota che indica che il dashboard ha superato le dimensioni limit e mostra le dimensioni effettive del dashboard corrente.
• Se la dimensione combinata del file supera 6 MB: solo il PDF è allegato all’email. Il messaggio inline include un collegamento al dashboard, ma nessuna immagine.

Scaricare come PDF

Per scaricare una dashboard come file PDF, fare clic sul menu kebab in alto a destra della dashboard e selectScarica come PDF.

Spostare un dashboard legacy nel Cestino

Per spostare un dashboard nel Cestino, seguire questa procedura:

1. Fare clic sul menu kebab in alto a destra del cruscotto e selectSposta nel Cestino.
2. Confermare facendo clic su Sposta nel cestino.

Restore un dashboard ereditato dal Cestino

1. Fare clic su Area di lavoro nella barra laterale.
2. Fare clic su Cestino nel visualizzatore area di lavoro per visualizzare le risorse al suo interno.
3. Fare clic sul menu menu kebab accanto al dashboard che si vuole restore.
4. Fare clic su Restore. Viene visualizzata una finestra di dialogo Sposta.
5. Usare la finestra di dialogo Sposta per scegliere una nuova posizione per il dashboard ripristinato.

Eliminare definitivamente un dashboard legacy

1. Fare clic su Area di lavoro nella barra laterale.
2. Fare clic su Cestino nel visualizzatore area di lavoro per visualizzare le risorse al suo interno.
3. Fare clic sul menu kebab accanto al dashboard che si vuole restore.
4. Fare clic su Elimina definitivamente.
5. Confermare facendo clic su Elimina.

Apri una query

Per aprire la query visualizzata in un widget nell'editor SQL, fare clic sul menu kebab in alto a destra del widget e selectVisualizza Query.

Configurare le autorizzazioni del dashboard legacy e la titolarità del dashboard

È necessario disporre dell’autorizzazione CAN MANAGE in un dashboard per configurare le autorizzazioni. Per i livelli di autorizzazione del dashboard, vedere ACL del dashboard legacy.

1. Nella barra laterale, fare clic su Dashboard.
2. Fare clic su un dashboard.
3. Fare clic sul pulsante in alto a destra per aprire la finestra di dialogo Condivisione.
4. Cercare e select i gruppi o gli utenti e assegnare il livello di autorizzazione.
   1. Set il credentials per Esegui come visualizzatore per assegnare le autorizzazioni CAN EDIT o CAN MANAGE.
5. Fare clic su Aggiungi.

È possibile condividere rapidamente tutte le query associate al dashboard facendo clic sull'icona a forma di ingranaggio e selezionando Condividi tutte le query. Le query a cui fa riferimento il dashboard hanno autorizzazioni separate e non vengono condivise per impostazione predefinita quando si condivide il dashboard.

Trasferire la titolarità di un dashboard legacy

Se il proprietario di un dashboard viene rimosso da un'area di lavoro, il dashboard non ha più un proprietario. Un utente amministratore dell'area di lavoro può trasferire la titolarità di qualsiasi dashboard, anche uno senza proprietario, a un utente diverso. La titolarità di alcuna dashboard non è assegnabile ai gruppi. È anche possibile trasferire la titolarità usando l'API delle autorizzazioni.

1. Come amministratore dell'area di lavoro, accedere all'area di lavoro di Azure Databricks.

2. Nella barra laterale, fare clic su Dashboard.

3. Fare clic su un dashboard.

4. Fare clic sul pulsante Condividi in alto a destra per aprire la finestra di dialogo Condivisione.

5. Fare clic sull'icona a forma di ingranaggio in alto a destra e fare clic su Assegna nuovo proprietario.

   

6. Select l'utente a cui assegnare la proprietà.

7. Cliccare Conferma.

Accedere alla visualizzazione come amministratore

Un utente amministratore dell'area di lavoro di Azure Databricks ha accesso a tutti i dashboard nell'area di lavoro. In questa visualizzazione, un amministratore dell'area di lavoro può visualizzare ed eliminare qualsiasi dashboard. Tuttavia, un amministratore dell'area di lavoro non può modificare un dashboard quando le impostazioni di condivisione credentials sono set per Esegui come proprietario.

Per visualizzare tutti i dashboard legacy:

1. Fare clic su Dashboard nella barra laterale.
2. Fare clic sulla scheda Dashboard legacy.
3. Fare clic sulla scheda Tutti i dashboard vicino alla parte superiore della schermata.