Sintassi dei parametri *mustache*

Nell'editor SQL legacy qualsiasi stringa racchiusa tra parentesi graffe doppie ({{ }}) viene considerata come parametro di query. Un widget viene visualizzato sopra il riquadro dei risultati in cui si imposta il valore del parametro.

Aggiungere un parametro "mustache"

1. Premere Cmd + I. Il parametro viene inserito nella posizione del cursore e viene visualizzata la finestra di dialogo Aggiungi parametro .
2. Immettere la parola chiave, facoltativamente modificare il titolo e selezionare un tipo.
3. Fare clic su Aggiungi parametro.
4. Impostare il valore del parametro nel widget.
5. Fare clic su Applica modifiche.
6. Fare clic su Salva.

In alternativa, digitare {{ }} direttamente nella query e fare clic sull'icona a forma di ingranaggio nel widget del parametro per configurarlo.

Per eseguire nuovamente la query con un valore diverso, aggiornare il widget e fare clic su Applica modifiche.

Modificare, rimuovere e riordinare i parametri

Modifica: fare clic sull'icona a forma di ingranaggio accanto al widget del parametro. Per impedire agli utenti che non possiedono la query di modificare il valore del parametro, fare clic su Mostra solo risultati.

Remove: eliminare l'indicatore di parametro dalla query. Il widget viene rimosso automaticamente.

Riordina: fare clic e trascinare i widget dei parametri nell'ordine desiderato.

Tipi di widget

Sono disponibili i tipi di widget seguenti:

Text

Accetta una stringa come input. Il backslash, le virgolette singole e doppie vengono automaticamente convertiti con caratteri di escape. Azure Databricks aggiunge virgolette intorno al valore.

SELECT * FROM samples.tpch.customer WHERE c_name = {{ name_param }}

Number

Accetta un numero come input.

SELECT * FROM users WHERE age = {{ number_param }}

Data e ora

Parametrizza i valori di data e timestamp. Sono disponibili tre opzioni:

Tutti i valori di data e ora vengono passati come valori letterali stringa e devono essere racchiusi tra virgolette singole nella query:

SELECT * FROM usage_logs WHERE date = '{{ date_param }}'

Quando si seleziona un'opzione Range , Azure Databricks crea due parametri usando .start e .end suffissi:

SELECT * FROM usage_logs
WHERE modified_time > '{{ date_range.start }}'
AND modified_time < '{{ date_range.end }}'

Valori di data dinamici: i widget data includono un'icona a forma di fulmine blu. Fare clic su di esso per selezionare valori dinamici, todayad esempio , yesterdaythis week, last week, last month, o last year. Questi valori vengono aggiornati automaticamente.

Elenco a discesa

Limita l'input a un elenco statico predefinito. Supporta sia la selezione a valore singolo che multivalore.

• Valore singolo: racchiudere il parametro tra virgolette singole nella query.

• Multivalore: abilita Consenti più valori nelle impostazioni del widget. Usare l'opzione Virgolette per controllare se i valori vengono racchiusi tra virgolette singole, virgolette doppie o nessuna. Aggiornare la WHERE clausola per usare IN:

  SELECT * FROM orders WHERE status IN ( {{ status_param }} )
  

  Con le virgolette doppie selezionate, la query viene risolta in: WHERE status IN ("value1", "value2", "value3").

I valori dell'elenco a discesa sono stringhe. Per usare date o timestamp, immetterli nel formato richiesto dall'origine dati.

Query-Based elenco a discesa

Popola le selezioni a discesa da una query salvata. Si comporta come elenco a discesa, ma le opzioni sono dinamiche.

1. Selezionare in Tipo nel pannello delle impostazioni l'elenco a discesa basato su query.
2. Fare clic sul campo Query e selezionare una query salvata.

Se la query restituisce più colonne, Azure Databricks usa la prima colonna. Se la query restituisce colonne denominate name e value, il widget visualizza la name colonna ma passa l'oggetto associato value alla query in fase di esecuzione.

Esempio:

SELECT user_uuid AS 'value', username AS 'name' FROM users

Il valore passato al database in fase di esecuzione è 1001, 1002o 1003, non il nome visualizzato.

Usare i parametri mustache nei dashboard legacy

Facoltativamente, le query possono usare parametri o valori statici. Quando una visualizzazione basata su una query con parametri viene aggiunta a un dashboard, è possibile configurare ogni parametro per l'uso di una delle tre origini valore:

• Parametro del widget: si applica solo alla singola visualizzazione a cui appartiene. Il selettore di valori viene visualizzato all'interno del pannello di visualizzazione.
• Parametro dashboard: può essere applicato a più visualizzazioni nel dashboard. Il selettore di valori viene visualizzato nella parte superiore del dashboard. Aggiunta per impostazione predefinita quando si aggiunge una visualizzazione con parametri a un dashboard.
• Valore statico: sostituisce il parametro con un valore fisso. Il selettore di valori è nascosto, mantenendo pulita l'interfaccia utente del dashboard per i parametri che non devono essere modificati.

Per accedere alle impostazioni di mapping dei parametri, fare clic sul menu kebab in un widget del dashboard e selezionare Modifica impostazioni widget.

Proprietà dei parametri del dashboard