Usare i parametri nei dashboard di Esplora dati di Azure

I parametri vengono usati come blocchi predefiniti per i filtri nei dashboard di Azure Esplora dati. Vengono gestiti nell'ambito del dashboard e possono essere aggiunti alle query per filtrare i dati presentati dall’oggetto visivo sottostante. La query può usare uno o più parametri.

Questo documento descrive la creazione e l'uso di parametri e filtri collegati nei dashboard. I parametri possono essere usati per filtrare gli oggetti visivi del dashboard selezionando i valori dei parametri nella barra dei filtri o usando filtri incrociati.

Gli esempi di query usati in questo articolo sono basati sulla StormEvents tabella nella raccolta di esempi.

Nota

La gestione dei parametri è disponibile in modalità di modifica per gli editor di dashboard.

Prerequisiti

• Visualizzare i dati con i dashboard di Esplora dati di Azure
• Autorizzazioni dell'editor in un dashboard di Azure Esplora dati
• Un dashboard con oggetti visivi

Visualizzare l'elenco dei parametri

Per visualizzare l'elenco di tutti i parametri del dashboard, selezionare il pulsante Parametri nella parte superiore del dashboard.

Creare un parametro

Per creare un parametro:

1. Passare dalla modalità visualizzazione alla modalità di modifica .

   

2. Selezionare il pulsante Parametri nella parte superiore del dashboard.

   

3. Selezionare il pulsante + Nuovo parametro nella parte superiore del riquadro destro.

4. Compilare le proprietà pertinenti per il parametro.

Proprietà supportate

Nel riquadro Aggiungi parametro configurare le proprietà seguenti:

Campo	Descrizione
Etichetta	Il nome del parametro visualizzato nel dashboard o nella scheda di modifica.
Tipo parametro	Uno dei parametri seguenti: Selezione singola: è possibile selezionare un unico valore nel filtro come input per il parametro. Selezione multipla: è possibile selezionare uno o più valori nel filtro come input per il parametro. Intervallo di tempo: consente di creare parametri aggiuntivi per filtrare le query e i dashboard in base al tempo. Per impostazione predefinita, ogni dashboard ha una selezione intervallo di tempo. Testo libero: non contiene valori popolati nel filtro. L'utente può digitare un valore o copiare/incollare un valore nel campo di testo. Il filtro mantiene i valori recenti utilizzati.
Nome variabile	Il nome del parametro da usare nella query. Suggerimento: il prefisso dei nomi delle variabili con un carattere distintivo, ad esempio un carattere di sottolineatura (_), semplifica la ricerca durante la scrittura di query.
Tipo di dati	Il tipo di dati dei valori del parametro.
Mostrare nelle pagine	Selezionare le pagine in cui verrà visualizzato questo parametro. L'opzione Seleziona tutto mostra il parametro in tutte le pagine.
Origine	L'origine dei valori dei parametri: Valori fissi: valori di filtro statici introdotti manualmente. Query: valori introdotti dinamicamente con una query KQL.
Valore predefinito	Valore predefinito del filtro. Il filtro inizierà sempre con il valore predefinito al rendering iniziale del dashboard.
Aggiungere un valore "Seleziona tutto"	Applicabile solo ai tipi di parametro con selezione singola e multipla. Consente di recuperare i dati per tutti i valori dei parametri. Questo valore deve essere integrato nella query per fornire la funzionalità. Per altri esempi di compilazione di tali query, vedere Usare il parametro basato su query a selezione multipla.

Gestisci parametri

Dopo aver selezionato Parametri nella barra superiore, è possibile visualizzare l'elenco dei parametri esistenti. In ogni scheda dei parametri selezionare il widget della matita per modificare il parametro oppure selezionare il menu Altro [...] su Duplica, Elimina o spostare il parametro.

Nella scheda dei parametri è possibile visualizzare gli indicatori seguenti:

• Parameter display name (Nome visualizzato parametro)
• Nomi di variabili
• Numero di query in cui è stato usato il parametro
• Pagine a cui viene aggiunto il parametro

Le schede dei parametri possono essere ordinate trascinando e rilasciando o usando l'opzione Sposta in > e selezionando la nuova posizione.

Usare i parametri nella query

È necessario usare un parametro nella query per rendere applicabile il filtro per l'oggetto visivo della query. Dopo aver definito, è possibile visualizzare i parametri nella barra superiore del filtro della pagina >Query e nella query intellisense.

Nota

Se il parametro non viene usato nella query, il filtro rimane inattivo. Dopo aver aggiunto il parametro alla query, il filtro diventa attivo.

Tipi di parametro

Sono supportati diversi tipi di parametri del dashboard, come indicato di seguito:

• Parametro intervallo di tempo predefinito
• Parametri a valori fissi a selezione singola
• Parametri a valori fissi a selezione multipla
• Parametri basati su query a selezione singola
• Parametri basati su query a selezione multipla
• Parametri di testo libero
• Parametri dell'origine dati

Negli esempi seguenti viene descritto come usare i parametri in una query per vari tipi di parametro.

Parametro intervallo di tempo predefinito

Per impostazione predefinita, ogni dashboard ha un parametro Intervallo di tempo . Viene visualizzato nel dashboard come filtro solo se usato in una query. Usare le parole chiave del _startTime parametro e _endTime per usare il parametro intervallo di tempo predefinito in una query, come illustrato nell'esempio seguente:

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

Dopo il salvataggio, il filtro dell'intervallo di tempo viene visualizzato nel dashboard. Ora può essere usato per filtrare i dati nella scheda. È possibile filtrare il dashboard selezionando dall'elenco a discesa Intervallo di tempo (ultimi x minuti/ore/giorni) o un intervallo di tempo personalizzato.

Parametri a valori fissi a selezione singola

I parametri a valore fisso sono basati su valori predefiniti specificati dall'utente. Nell'esempio seguente viene illustrato come creare un singolo parametro con valore fisso di selezione.

Creare un parametro a valori fissi a selezione singola

1. Selezionare Parametri per aprire il riquadro Parametri e selezionare Nuovo parametro.

2. Compilare i dettagli come indicato di seguito:

   • Etichetta: tipo di evento

   • Tipo di parametro: selezione singola

   • Nome variabile: _eventType

   • Tipo di dati: String

   • Aggiungi come filtro del dashboard: selezionato

   • Origine: valori fissi

     In questo esempio usare i valori seguenti:

     Valore	Parameter display name (Nome visualizzato parametro)
     Vento di tempesta	Vento temporale
     Grandine	Grandine
     Piena improvvisa	Inondazione flash
     Siccità	Siccità
     Meteo invernale	Meteo invernale

   • Aggiungi un valore Seleziona tutto : Deselezionato

   • Valore predefinito: Vento temporale

3. Selezionare Fine per creare il parametro.

Il parametro può essere visualizzato nel riquadro laterale Parametri , ma attualmente non viene usato in alcun oggetto visivo.

Usare un parametro a valori fissi a selezione singola

1. Eseguire una query di esempio usando il nuovo parametro Event TypTope usando il nome della _eventType variabile:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType == _eventType
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Il nuovo parametro viene visualizzato nell'elenco dei parametri nella parte superiore del dashboard.

2. Selezionare valori diversi per aggiornare gli oggetti visivi.

   

Parametri a valori fissi a selezione multipla

I parametri a valore fisso sono basati su valori predefiniti specificati dall'utente. Nell'esempio seguente viene illustrato come creare e usare un parametro a valore fisso a selezione multipla.

Creare parametri a valori fissi di selezione multipla

1. Selezionare Parametri per aprire il riquadro Parametri e selezionare Nuovo parametro.

2. Compilare i dettagli come indicato in Usare un parametro a valori fissi a selezione singola con le modifiche seguenti:

   • Etichetta: tipo di evento
   • Tipo di parametro: selezione multipla
   • Nome variabile: _eventType

3. Selezionare Fine per creare il parametro.

I nuovi parametri possono essere visualizzati nel riquadro laterale Parametri , ma attualmente non vengono usati in alcun oggetto visivo.

Usare un parametro a valori fissi a selezione multipla

1. Eseguire una query di esempio usando il nuovo parametro Tipo di evento usando la _eventType variabile .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Il nuovo parametro viene visualizzato nell'elenco dei parametri nella parte superiore del dashboard.

2. Selezionare uno o più valori diversi per aggiornare gli oggetti visivi.

   

Parametri basati su query a selezione singola

I valori dei parametri basati su query vengono recuperati durante il caricamento del dashboard eseguendo la query dei parametri. Nell'esempio seguente viene illustrato come creare e usare un singolo parametro basato su query di selezione.

Creare un parametro basato su query a selezione singola

1. Selezionare Parametri per aprire il riquadro Parametri e selezionare Nuovo parametro.

2. Compilare i dettagli come indicato in Usare un parametro a valori fissi a selezione singola con le modifiche seguenti:

   • Etichetta: Stato

   • Nome variabile: _state

   • Origine: Query

   • Origine dati: StormEventsSample

   • Selezionare Modifica query e immettere la query seguente. Selezionare Fine.

     StormEvents
     | where StartTime between (_startTime.._endTime)
     | where EventType in (_eventType) or isempty(_eventType)
     | summarize TotalEvents = count() by State
     | top 5 by TotalEvents
     | project State
     

   • Valore: Stato

   • Nome visualizzato: Stato

   • Valore predefinito: scegliere un valore predefinito

3. Selezionare Fine per creare il parametro.

Usare un parametro basato su query a selezione singola

1. La query di esempio seguente con il nuovo parametro State usa la _state variabile :

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State == _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Il nuovo parametro viene visualizzato nell'elenco dei parametri nella parte superiore del dashboard.

2. Selezionare valori diversi per aggiornare gli oggetti visivi.

Parametri basati su query a selezione multipla

I valori dei parametri basati su query vengono derivati in fase di caricamento del dashboard eseguendo la query specificata dall'utente. L'esempio seguente illustra come creare un parametro basato su query a selezione multipla:

Creare un parametro basato su query a selezione multipla

1. Selezionare Parametri per aprire il riquadro Parametri e selezionare + Nuovo parametro.

2. 1. Compilare i dettagli come indicato in Usare un parametro a valori fissi a selezione singola con le modifiche seguenti:
   • Etichetta: Stato
   • Tipo di parametro: selezione multipla
   • Nome variabile: _state

3. Selezionare Fine per creare il parametro.

Usare un parametro basato su query a selezione multipla

1. La query di esempio seguente usa il nuovo parametro State usando la _state variabile .

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State in (_state) or isempty(_state)
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

   Nota

   In questo esempio viene utilizzata l'opzione Seleziona tutto controllando la presenza di valori vuoti con la isempty() funzione .

   Il nuovo parametro viene visualizzato nell'elenco dei parametri nella parte superiore del dashboard.

2. Selezionare uno o più valori diversi per aggiornare gli oggetti visivi.

Parametri di testo libero

I parametri di testo libero non contengono valori. Consentono di introdurre il proprio valore.

Creare un parametro di testo libero

1. Selezionare Parametri per aprire il riquadro Parametri e selezionare + Nuovo parametro.

2. Compilare i dettagli come indicato di seguito:

   • Etichetta: Stato
   • Tipo di parametro: Testo libero
   • Nome variabile: _state
   • Tipo di dati: String
   • Valore predefinito: nessun valore predefinito

Usare un parametro di testo libero

1. Eseguire una query di esempio usando il nuovo parametro State usando il nome della _state variabile:

   StormEvents
   | where StartTime between (_startTime.._endTime)
   | where EventType in (_eventType) or isempty(_eventType)
   | where State contains _state
   | summarize TotalEvents = count() by State
   | top 5 by TotalEvents
   

Parametri dell'origine dati

Dopo aver aggiunto origini dati al dashboard, è possibile creare un parametro che seleziona una o più origini dati disponibili. Questo parametro può essere usato nei riquadri e in altri parametri.

Creare un parametro di origine dati

1. Selezionare Parametri per aprire il riquadro Parametri e selezionare + Nuovo parametro.

2. Compilare i dettagli come indicato di seguito:

   • Etichetta: Origine
   • Tipo di parametro: origine dati
   • Mostra nelle pagine: Selezionare tutto
   • Valori: Selezionare tutto
   • Valore predefinito: StormEventsSample

3. Selezionare Fine.

Il nuovo parametro è ora visibile nell'elenco dei parametri nella parte superiore del dashboard.

Usare un parametro di origine dati

1. Passare alla query di un riquadro nuovo o esistente.

2. In Origine selezionare il nome del nuovo parametro in Parametri origine dati. Per il parametro creato in precedenza, selezionare Cluster.

3. Fare clic su Applica modifiche.

4. Usare il parametro Cluster per modificare l'origine dati per questa query connessa.

Parametri tra filtri

I filtri incrociati consentono di selezionare un valore in un oggetto visivo e in tutti gli oggetti visivi del dashboard, ad esempio grafici a linee o a dispersione, vengono filtrati solo per visualizzare i dati correlati. L'uso di filtri incrociati ottiene lo stesso risultato della selezione del valore equivalente per il parametro nell'elenco dei parametri nella parte superiore del dashboard.

Definire i filtri incrociati

Per creare un filtro incrociato, è necessario attivare l'opzione nell'oggetto visivo e quindi specificare il parametro usato per filtrare i dati.

1. Passare alla query del riquadro in cui si desidera aggiungere filtri incrociati.

2. Selezionare Oggetto visivo.

3. Nel riquadro destro selezionare Interazioni e quindi attivare filtri incrociati.

4. Facoltativamente, specificare il tipo di interazione . Il valore predefinito è Punto in cui è possibile selezionare un valore nell'oggetto visivo. Per selezionare un intervallo di valori, ad esempio in un grafico temporale, selezionare Trascina.

5. Specificare entrambe le colonne usate per specificare il valore e un parametro utilizzato per filtrare la query.

   Importante

   La colonna e il parametro devono essere dello stesso tipo di dati.

Interagire con i dati usando il filtro incrociato

Dopo aver definito il filtro incrociato, è possibile usarlo per interagire con i dati. Negli oggetti visivi in cui sono stati definiti filtri incrociati, è possibile selezionare i punti dati e usare i relativi valori per filtrare la pagina del dashboard corrente. Per gli oggetti visivi tabella selezionare punti dati facendo clic con il pulsante destro del mouse sulla cella pertinente e quindi nel menu di scelta rapida selezionare Filtro incrociato.

È possibile reimpostare il filtro incrociato selezionando Reimposta nella parte superiore dell'oggetto visivo in cui è stato selezionato.

Usare drill-through come parametri del dashboard

Con il drill-through è possibile selezionare un valore in un oggetto visivo e usarlo per filtrare gli oggetti visivi in una pagina di destinazione nello stesso dashboard. Quando si apre la pagina di destinazione, il valore viene preelette nei filtri pertinenti. Gli oggetti visivi nella pagina, ad esempio grafici a dispersione o riga, vengono filtrati per visualizzare solo i dati correlati.

Definire un drill-through

Per creare un drill-through, è prima necessario attivarlo nell'oggetto visivo e quindi aggiungere una o più drill-through in base alle esigenze.

1. Modificare l'oggetto visivo in cui si vuole aggiungere un drill-through. Assicurarsi che sia selezionata la scheda Visual .

2. Nel riquadro destro selezionare Interazioni e quindi attivare il drill-through.

   

3. In Drill-through selezionare Crea nuovo e specificare le informazioni seguenti. Facoltativamente selezionare Aggiungi un'altra coppia per aggiungere più parametri per una pagina di destinazione. Ripetere questo passaggio per aggiungere drill-through ad altre pagine nel dashboard corrente usando parametri diversi.

   Campo	Descrizione
   pagina Destination	Una o più pagine di destinazione da eseguire per eseguire il drill-through usando i parametri definiti.
   Colonna	Colonna del risultato della query da usare come valore per un parametro nella pagina di destinazione.
   Parametro	Parametro utilizzato per filtrare gli oggetti visivi nella pagina di destinazione usando il valore della colonna.
   Note	Descrizione breve facoltativa.

   Importante

   Le coppie di colonne e parametri devono essere dello stesso tipo di dati.

Interagire con i dati usando drill-through

Dopo aver definito i drill-through, è possibile usarli per interagire con i dati. A tale scopo, negli oggetti visivi o nelle tabelle in cui è stato definito un drill-through, fare clic con il pulsante destro del mouse su un punto dati e quindi selezionare Drill-through to destination page (Eseguire il drill-through nella>pagina di destinazione). I valori del punto dati verranno usati come parametri per filtrare gli oggetti visivi nella pagina di destinazione.

Per tornare alla pagina di origine, nella parte superiore destra della pagina di destinazione selezionare Reimposta. Tutti i filtri assegnati dal drill-through verranno reimpostati.

Usare la ricerca del filtro per filtri singoli e più filtri di selezione

In filtri di selezione singoli e multipli digitare il valore desiderato. Il filtro viene aggiornato per visualizzare solo i valori corrispondenti al termine di ricerca.

Contenuti correlati

• Personalizzare gli oggetti visivi dei dashboard di Esplora dati di Azure
• Scrivere query Linguaggio di query Kusto nell'interfaccia utente Web