Usare 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
- Si è connessi a un'area di lavoro di Azure Databricks.
- Si ha il diritto SQL nell'area di lavoro.
- È disponibile almeno l'accesso A U edizione Standard a uno o più warehouse SQL.
Creare un set di dati del dashboard
Questa esercitazione usa i dati generati dal catalogo degli esempi in Azure Databricks.
Fare clic su
Nuovo nella barra laterale e selezionare Dashboard dal menu.
Fare clic sulla scheda Dati .
Fare clic su Crea da SQL e incollare la query seguente nell'editor. Fare quindi clic su Esegui per restituire i risultati.
SELECT * FROM samples.tpch.customer
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. Il parametro in questo esempio è :segment
. Per altre informazioni sulla sintassi dei parametri, vedere Che cosa sono i parametri del dashboard.
Incollare la clausola seguente
WHERE
nella parte inferiore della query. Sotto la query viene visualizzato un campo di testo con il nomesegment
del parametro.WHERE c_mktsegment = :segment
Digitare
BUILDING
nel campo di testo sotto la query per impostare il valore predefinito per il parametro .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:
- Fare clic sulla scheda Canvas .
- 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
- Se necessario, selezionare Barra dal menu a discesa Visualizzazione .
- Fare clic
per scegliere i dati presentati lungo l'asse X. È possibile usare la barra di ricerca per cercare un campo in base al nome. Selezionare c_nationkey.
- 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
- Fare clic
accanto all'asse Y, quindi selezionare c_acctbal.
- 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.
- Fare clic su
Aggiungi un filtro (campo/parametro) per aggiungere un widget di filtro. Posizionarlo nell'area di disegno.
- Nel menu a discesa Filtro nel pannello di configurazione selezionare Valore singolo.
- Selezionare la casella di controllo Titolo per visualizzare un campo titolo nel widget filtro.
- Fare clic sul titolo segnaposto nel widget e digitare Segment per ritirare il filtro.
- Fare clic
accanto a Parametri nel pannello di configurazione.
- 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.
Fare clic sulla scheda Dati .
Fare clic su Crea da SQL per creare un nuovo set di dati.
Copiare e incollare quanto segue nell'editor:
SELECT DISTINCT c_mktsegment FROM samples.tpch.customer
Eseguire la query ed esaminare i risultati. I cinque segmenti di marketing della tabella vengono visualizzati nei risultati.
Fare doppio clic sul titolo generato automaticamente, quindi rinominare questa opzione segmento del set di dati.
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.
- Fare clic su Canvas. Fare quindi clic sul widget di filtro creato in un passaggio precedente.
- Fare clic
accanto a Campi.
- Fare clic su Scelta segmento, quindi fare clic sul nome
c_mktsegment
del campo .
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 Filtri.
- Altre informazioni sui parametri del dashboard. Vedere Che cosa sono i parametri del dashboard?.
- Pubblicare e condividere il dashboard. Vedere Pubblicare un dashboard.
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per