Le funzioni native sono disattivate per impostazione predefinita. Consulta la sezione Attivazione delle funzioni native di questo articolo per istruzioni su come abilitarle.
La funzione NATIVE_DIMENSION consente di scrivere codice SQL direttamente in un campo di Looker Studio. Questo è utile per le funzioni che non sono incluse nell'elenco delle funzioni, ma sono supportate dal tuo database.
- Attivare le funzioni native
- Esempi di utilizzo
- Sintassi
- Esempi di NATIVE_DIMENSION
- Limiti di NATIVE_DIMENSION
- Risorse correlate
Attivare le funzioni native
Le funzioni native sono disattivate per impostazione predefinita e sono gestite a livello di origine dati.
La funzione NATIVE_DIMENSION può essere utilizzata solo con un'origine dati Google BigQuery per la quale è abilitata l'integrazione nativa di BigQuery in Looker Studio.
Se sei proprietario di un'origine dati Google BigQuery, puoi attivare le funzioni native per l'origine dati seguendo questa procedura:
- Attiva l'integrazione nativa di BigQuery in Looker Studio.
- In Looker Studio, modifica l'origine dati.
- In alto a destra nell'editor dell'origine dati, fai clic su Funzioni native.
- Nella finestra di dialogo Funzioni native, seleziona On.
- Fai clic su Salva.
Se disattivi le funzioni native, nessun utente potrà utilizzarle per creare campi. Inoltre, tutti i grafici esistenti che fanno riferimento a campi con funzioni native mostreranno un errore.
Esempi di utilizzo
NATIVE_DIMENSION("JSON_VALUE('{"name": "Dana"}', '$.name')","STRING")
Sintassi
NATIVE_DIMENSION(expression, type)
Parametri
expression: un'espressione che deve essere valutata dal set di dati sottostante. Può trattarsi di qualsiasi espressione SQL di Google BigQuery valida che sarà inserita in una singola colonna di un'istruzione SELECT. L'espressione non può includere aggregazioni.
type: un valore letterale di tipo di dati. Consulta la sezione seguente per conoscere i tipi supportati da questa funzione.
Tipi NATIVE_DIMENSION
Puoi scegliere tra i seguenti tipi:
| Tipo | Dati previsti | Esempi di report |
|---|---|---|
|
Zero o più lettere, numeri, caratteri o simboli. |
|
BOOL |
Un valore logico. |
|
DOUBLE |
Un numero con rappresentazione in virgola mobile. | 1234,56 |
INT64 |
Un numero intero. | 1234 |
DATE |
Una data di calendario. |
|
DATETIME |
Una data di calendario con l'ora. | 2020-09-21 12:35 PM |
GEOGRAPHY |
Un insieme di punti e poligoni che corrispondono al tipo di dati geografici di BigQuery. Sono supportate solo le funzioni BigQuery |
|
Looker Studio restituirà un errore se l'espressione restituisce un tipo di dati non supportato, come ARRAY, STRUCT o JSON.
Esempi di NATIVE_DIMENSION
Funzioni JSON in SQL
Supponiamo che i tuoi dati includano un campo users_ages_json i cui valori sono formattati come payload JSON. Un esempio di valore di riga di questo campo può essere simile al seguente:
{"name": "Jakob", "age": "26"}
Utilizza la funzione NATIVE_DIMENSION per recuperare l'età da users_ages_json, utilizzando la funzione JSON_VALUE di BigQuery:
NATIVE_DIMENSION("JSON_VALUE(user_ages_json, '$.age')","INT64")
Per questo esempio di valore di riga, la funzione NATIVE_DIMENSION restituirebbe l'età 26 sotto forma di numero intero.
Limiti di NATIVE_DIMENSION
Origini dati supportate
La funzione NATIVE_DIMENSION può essere utilizzata solo con un'origine dati Google BigQuery per la quale è abilitata l'integrazione nativa di BigQuery in Looker Studio.
Chi può utilizzare le funzioni native
Se le funzioni native sono attivate, i proprietari e gli editor dell'origine dati possono creare campi con funzioni native nell'origine dati.
I visualizzatori dell'origine dati possono utilizzare i campi con funzioni native nei grafici, ma non possono creare nuovi campi né modificare quelli esistenti utilizzando le funzioni native.
Campi aggregati
Non puoi include any campi aggregati nel parametro expression.
Funzioni finestra
Non puoi include any funzioni finestra nel parametro expression.
Combinazioni
Non puoi creare un campo con la funzione NATIVE_DIMENSION in un'origine dati combinata.
Tuttavia, puoi creare un campo con questa funzione prima della combinazione e poi utilizzarlo in una combinazione.
Tipi di dati TIMESTAMP
Se l'espressione restituisce un tipo di dati timestamp, ad esempio TIMESTAMP di BigQuery, utilizza la funzione CAST per trasmetterlo a un tipo DATETIME. Ecco alcuni esempi:
NATIVE_DIMENSION("CAST({expression} AS DATETIME)", "DATETIME")