BigQuery
Esegui query SQL in sola lettura su BigQuery, con esempi UNNEST per i campi annidati, e porta i risultati nel foglio.
Il connettore BigQuery esegue una query SQL di tua scelta, in sola lettura, sui tuoi dati Google BigQuery. L'autorizzazione avviene con il tuo account Google (stesso accesso di Google Analytics 4 o Google Ads) - non serve nessuna chiave API o service account.
Quando crei un report specifichi due cose: un Project ID di fatturazione (il progetto Google Cloud su cui viene fatturata la query, in base ai byte scansionati - non necessariamente il progetto dove si trovano i tuoi dati, dato che puoi referenziare tabelle di altri progetti direttamente nella query), e la query SQL stessa, in BigQuery Standard SQL.
Non è ammessa nessuna query diversa da SELECT (anche precedute da WITH): niente INSERT/UPDATE/DELETE/DDL, verificato prima di ogni esecuzione.
Campi annidati e ripetuti (RECORD/STRUCT, array): le tabelle BigQuery - soprattutto export come quello GA4→BigQuery - contengono spesso campi che racchiudono un'intera struttura o una lista di valori in un'unica colonna (es. event_params nell'export GA4). Una cella del foglio non può contenere una struttura annidata nativa, quindi il connettore si comporta in due modi diversi a seconda di come scrivi la query:
- Se selezioni il campo così com'è, senza appiattirlo nella query, il connettore lo scrive come testo JSON nella cella - questo garantisce che nessun dato vada perso silenziosamente, anche per campi che non avevi pensato di appiattire, ma non è piacevole da leggere.
- L'approccio consigliato è appiattire il campo direttamente nella query SQL, con
UNNEST. Ci sono due pattern comuni:
Pattern 1 - estrarre un singolo valore (mantiene una riga per record originale), utile quando ti serve solo un valore specifico dentro la struttura:
SELECT event_date, event_name,
(SELECT value.string_value FROM UNNEST(event_params) WHERE key = 'page_location') AS page_location
FROM `progetto.dataset.events_*`
WHERE _TABLE_SUFFIX = '20261029'Pattern 2 - esplodere in più righe (una riga per elemento dell'array), utile quando vuoi ogni coppia chiave/valore come riga leggibile a sé invece di un singolo valore:
SELECT event_date, event_name, ep.key, ep.value.string_value AS value
FROM `progetto.dataset.events_*`, UNNEST(event_params) AS ep
WHERE _TABLE_SUFFIX = '20261029'Suggerimento per aggiornamenti giornalieri: per scaricare automaticamente solo i dati nuovi ogni giorno (es. con uno schedule e "Append new results to old" attivo), scrivi direttamente nella query una condizione su un campo data, calcolata al momento dell'esecuzione, ad esempio un wildcard su tabelle shardate per data con _TABLE_SUFFIX, oppure WHERE event_date = CURRENT_DATE(). La query salvata resta sempre la stessa stringa, ma il risultato cambia ogni giorno perché la condizione viene calcolata quando il report viene eseguito.
Metriche disponibili
Non esistono metriche o dimensioni fisse: le colonne del report sono esattamente le colonne restituite dalla tua query SQL (i nomi delle colonne o degli alias usati nella SELECT). Numeri, date e timestamp vengono convertiti automaticamente in base ai tipi dichiarati dallo schema BigQuery stesso - nessuna conversione manuale necessaria.
Limiti noti
- Solo query SELECT (o WITH)Una sola istruzione per query, niente INSERT/UPDATE/DELETE/DDL: verificato prima di ogni esecuzione. Una query che non supera il controllo mostra un errore invece di essere eseguita.
- Le query vengono fatturate sul tuo progetto Google CloudBigQuery addebita in base ai byte scansionati da ogni query, fatturati sul progetto che indichi come "Project ID di fatturazione" al momento della creazione del report - indipendentemente da quale progetto contenga davvero i dati. Scrivi query selettive (filtra su colonne partizionate/shardate, evita SELECT * su tabelle enormi) per controllare i costi.
- Nessun test al momento della connessioneLa pagina di connessione gestisce solo l'accesso: il test vero avviene la prima volta che selezioni quella connessione per configurare un report, non quando ti connetti.
- I campi annidati e ripetuti vanno letti con UNNEST per un risultato pulitoI campi che contengono una struttura (RECORD/STRUCT) o una lista (REPEATED, array) vengono scritti come testo JSON se li selezioni così come sono - corretto ma non piacevole da leggere. Appiattiscili nella query con UNNEST per un risultato pulito (vedi gli esempi sopra).