Usare i parametri basati su query

L'articolo illustra i passaggi per creare un dashboard interattivo che usa parametri basati su query. Presuppone una conoscenza di base della creazione di dashboard in Azure Databricks. Per istruzioni di base sulla creazione di dashboard, vedere Introduzione.

Requisiti

• Dopo avere eseguito l'accesso all'area di lavoro di Azure Databricks.
• Si ha il diritto SQL nell'area di lavoro.
• Si ha l'accesso CAN USE ad almeno uno o più warehouse SQL.

Creare un set di dati dashboard

Questa esercitazione usa i dati generati dal catalogo degli esempi in Azure Databricks.

1. Fare clic su Nuovo nella barra laterale e selezionare Dashboard dal menu.

2. Fare clic sulla scheda Dati .

3. Cliccare su Crea da SQL e incollare la query seguente nell'editor. Fare di nuovo clic su Esegui per restituire i risultati.

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. Il set di dati appena definito viene salvato automaticamente con il nome Set di dati senza titolo. Fare doppio clic sul titolo e rinominarlo Segmento marketing.

Aggiungere un parametro

È possibile aggiungere un parametro a questo set di dati per filtrare i valori restituiti. In questo esempio il parametro da immettere è :segment. Per altre informazioni sulla sintassi dei parametri, vedere Lavorare con i parametri del dashboard.

1. Incollare la clausola seguente WHERE nella parte inferiore della query. Sotto la query viene visualizzato un campo di testo con il nome segment del parametro.

   WHERE
     c_mktsegment = :segment
   

2. Digitare BUILDING nel campo di testo sotto la query per impostare il valore predefinito per il parametro.

3. Eseguire di nuovo la query per esaminare i risultati.

Configurare un widget di visualizzazione

Aggiungere una visualizzazione per il set di dati nell'area di disegno completando i passaggi seguenti:

1. Fare clic sulla scheda Canvas.
2. Fare clic su Aggiungi una visualizzazione per aggiungere un widget di visualizzazione e usare il mouse per posizionarlo nell'area di disegno.

Configurare l'asse X

1. Se necessario, selezionare Barra dal menu a discesa Visualizzazione.
2. Fare clic per scegliere i dati presentati lungo l'asse X. È possibile cercare una risorsa in base al nome usando il campo di ricerca. Selezionare c_nationkey.
3. Fare clic sul nome del campo selezionato per visualizzare opzioni di configurazione aggiuntive.
   • Come Tipo di scala, selezionare Categorico.
   • Per la selezione Trasforma scegliere Nessuno.

Configurare l'asse Y

1. Fare clic accanto all'asse Y, quindi selezionare c_acctbal.
2. Fare clic sul nome del campo selezionato per visualizzare opzioni di configurazione aggiuntive.
   • Come Tipo di scala, selezionare Quantitativo.
   • Per la selezione Trasforma, scegliere SUM.

La visualizzazione viene aggiornata automaticamente durante la configurazione. I dati visualizzati includono solo i record in cui segment è BUILDING.

Aggiungi un filtro

Configurare un filtro in modo che i visualizzatori del dashboard possano controllare il segmento di marketing su cui concentrarsi.

1. Fare clic su Aggiungi un filtro (campo/parametro) per aggiungere un widget di filtro. Posizionarlo nell'area di disegno.
2. Nel menu a discesa Filtro nel pannello di configurazione, selezionare Valore singolo.
3. Selezionare la casella di controllo Titolo per visualizzare un campo titolo nel widget filtro.
4. Fare clic sul titolo segnaposto nel widget e digitare Segmento per ritirare il filtro.
5. Fare clic accanto a Parametri nel pannello di configurazione.
6. Scegliere segmento dal set di dati del Segmento marketing.

Il widget filtro configurato mostra il valore del parametro predefinito per il set di dati.

Definire una selezione di valori

Il filtro creato è funzionale, ma richiede al visualizzatore di conoscere l'intervallo di scelte disponibile prima di poter digitare una selezione. Richiede inoltre che gli utenti corrispondano al caso e all'ortografia quando si immette il valore del parametro desiderato.

Per creare un elenco a discesa in modo che il visualizzatore possa selezionare un parametro da un elenco di opzioni disponibili, creare un nuovo set di dati per definire l'elenco dei valori possibili.

1. Fare clic sulla scheda Dati .

2. Fare clic su Crea da SQL per creare un nuovo set di dati.

3. Copiare e incollare il seguente nell'editor:

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. Eseguire la query ed esaminare i risultati. I cinque segmenti di marketing della tabella vengono visualizzati nei risultati.

5. Fare doppio clic sul titolo generato automaticamente, quindi rinominare questa opzione del set di dati Scelta segmento.

Aggiornare il filtro

Aggiornare il filtro esistente per usare il set di dati appena creato per popolare un elenco a discesa di valori tra cui gli utenti possono selezionare.

1. Fare clic su Canvas. Fare quindi clic sul widget di filtro creato in un passaggio precedente.
2. Fare clic su accanto a Campi.
3. Fare clic su Scelta segmento, quindi fare clic sul nome del campo c_mktsegment.

Il widget di filtro viene aggiornato man mano che si modifica la configurazione. Fare clic sul campo nel widget filtro per visualizzare le opzioni disponibili nel menu a discesa.

Nota

Questa esercitazione contiene un caso d'uso semplificato progettato per illustrare come usare parametri basati su query. Un approccio alternativo alla creazione di questo dashboard consiste nell'applicare un filtro al c_mktsegment campo.

Passaggi successivi

Continuare a imparare a usare i dashboard con gli articoli seguenti:

• Altre informazioni sull'applicazione di filtri. Vedere Usare i filtri.
• Altre informazioni sui parametri del dashboard. Vedere Lavorare con i parametri del dashboard.
• Pubblicare e condividere il dashboard. Vedere Pubblicare un dashboard.