I parametri consentono di creare report reattivi e personalizzabili trasferendo i parametri da un'origine dati alla query SQL sottostante. Per utilizzare un parametro all'interno della query personalizzata, segui le linee guida sulla sintassi descritte nell'articolo Esecuzione di query con parametri.
Parametri standard
Puoi utilizzare i seguenti parametri in qualsiasi query personalizzata:
Parametro |
Finalità |
|---|---|
|
Visualizza l'inizio dell'intervallo di date del report. |
|
Visualizza la fine dell'intervallo di date del report. |
|
Visualizza l'indirizzo email dell'utente che ha eseguito l'accesso. |
Per utilizzare questi parametri:
- Nella sezione Parameters (Parametri) del riquadro di connessione, attiva i parametri che vuoi utilizzare. Quando attivi il parametro
@DS_USER_EMAIL, Data Studio ti chiede di concedere l'accesso al tuo indirizzo email. - Nella query, utilizza la formattazione in maiuscolo quando digiti i nomi dei parametri.
Data Studio passa tutti i valori dei parametri come stringhe di testo. Per gestire le stringhe dei parametri come date di calendario, numeri o altri tipi di dati, utilizza una funzione di conversione SQL appropriata, ad esempio PARSE_DATE, PARSE_TIMESTAMP o CAST.
Utilizzare i parametri della data per trasmettere gli intervalli di date alla query sottostante
Se il report include un controllo intervallo di date, i visualizzatori possono usarlo per richiedere date di inizio e fine diverse direttamente dal database.
Utilizzare il parametro per l'email per fornire accesso a livello di riga ai dati
Il parametro per l'email consente di mostrare solo i dati associati all'utente che ha eseguito l'accesso a un report, a un'origine dati o a un'esplorazione. L'utente deve aver eseguito l'accesso a un Account Google e deve acconsentire a fornire il proprio indirizzo email a Data Studio. Se il visualizzatore non acconsente, tutti i grafici del report basati su questa origine dati mostreranno un errore di autorizzazione.
Parametri personalizzati
Nella query personalizzata puoi utilizzare qualsiasi parametro creato nell'interfaccia utente di Data Studio.
Creare un parametro nella pagina di connessione
- Nella sezione Parameters (Parametri) dell'editor di query personalizzate, fai clic su +ADD PARAMETER (+Aggiungi parametro).
- Configura le opzioni dei parametri.
- Fai clic su OK.
Nascondere i parametri personalizzati nell'origine dati
Per impostazione predefinita, gli editor dei report possono modificare i parametri personalizzati direttamente all'interno dei report. Puoi nascondere un parametro per impedire agli editor dei report di modificare il relativo valore direttamente nella configurazione dell'origine dati:
- Fai clic su Altre opzioni.
- Fai clic su Nascondi.
Scopri di più su come consentire l'utilizzo dei parametri delle origini dati nei report.
Utilizzare un parametro in una query personalizzata
Nel corpo della query SQL personalizzata, sostituisci un valore hardcoded con un identificatore che inizia con il carattere @ (ad esempio, @param_name).
Esempi di parametri
Di seguito sono riportati alcuni esempi di utilizzo dei parametri:
Esempio di parametro personalizzato
SELECT word FROM `TABLE` WHERE corpus = @corpus;
Stringa con CONTAINS e una soglia numerica
SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;
Parametro stringa a selezione multipla
Nota come UNNEST appiattisce l'elenco di array dei valori dei parametri a selezione multipla:
SELECT * from user.users as user WHERE display_name in UNNEST(@name);
Parametro data che utilizza la formattazione standard
SELECT creation_date, age, display_name from user.users as user
WHERE creation_date > PARSE_DATE('%Y%m%d', @DS_START_DATE)
AND creation_date < PARSE_DATE('%Y%m%d', @DS_END_DATE);
Parametro data che utilizza il timestamp Unix in microsecondi
SELECT creation_date, age, display_name from user.users as use
WHERE creation_date > UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_START_DATE))
AND creation_date < UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_END_DATE))
Esempio di parametro per l'email
SELECT * FROM Sales WHERE sales-rep-email = @DS_USER_EMAIL;