Condividi tramite


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.

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

  2. Fare clic sulla scheda Dati .

  3. 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
    
  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. Il parametro in questo esempio è :segment. Per altre informazioni sulla sintassi dei parametri, vedere Che cosa sono 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 Icona CreaAggiungi 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 Icona aggiungi campo 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.
  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 Icona aggiungi campoaccanto 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 è segmentBUILDING.

Widget di visualizzazione configurato come descritto nei passaggi precedenti.

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 Icona filtroAggiungi 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 Segment per ritirare il filtro.
  5. Fare clic Icona aggiungi campo 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.

Filtrare il widget configurato con un parametro, come descritto.

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 quanto segue 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 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.

  1. Fare clic su Canvas. Fare quindi clic sul widget di filtro creato in un passaggio precedente.
  2. Fare clic Icona aggiungi campo accanto a Campi.
  3. Fare clic su Scelta segmento, quindi fare clic sul nome c_mktsegmentdel 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.

Widget filtro configurato con un campo, come descritto.

Passaggi successivi

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