Utilizza Fogli connessi

Puoi utilizzare Fogli connessi per analizzare i set di dati BigQuery direttamente nell'interfaccia familiare di Fogli Google. Esplora i tuoi dati con grafici, formule e tabelle pivot, collabora con gli stakeholder e mantieni una Single Source Of Truth senza fare affidamento sulle esportazioni manuali dei fogli di lavoro.

Fogli connessi esegue le query BigQuery per tuo conto quando viene richiesto manualmente o in base a una pianificazione definita. I risultati di queste query vengono salvati nel foglio di lavoro per l'analisi e la condivisione.

Esempi di casi d'uso

Di seguito sono riportati solo alcuni casi d'uso che mostrano come Fogli connessi ti consente di analizzare grandi quantità di dati all'interno di un foglio, senza dover conoscere SQL.

• Pianificazione aziendale: crea e prepara i set di dati, quindi consenti ad altri di trovare insight dai dati. Ad esempio, analizza i dati di vendita per determinare quali prodotti vendono meglio in località diverse.

• Assistenza clienti: scopri quali negozi hanno il maggior numero di reclami per 10.000 clienti.

• Vendite: crea report finanziari e sulle vendite interni e condividi i report sulle entrate con i rappresentanti vendite.

Controllo degli accessi

L'accesso diretto ai set di dati e alle tabelle BigQuery è controllato all'interno di BigQuery. Se vuoi concedere a un utente l'accesso solo a Fogli Google, condividi un foglio di lavoro e non concedere l'accesso a BigQuery.

Un utente con accesso solo a Fogli Google può eseguire analisi nel foglio e utilizzare altre funzionalità di Fogli Google, ma non potrà eseguire le seguenti azioni:

• Aggiorna manualmente i dati di BigQuery nel foglio.
• Pianifica un aggiornamento dei dati nel foglio.

Quando filtri i dati in Fogli connessi, la query che invii a BigQuery viene aggiornata in base al progetto selezionato. Puoi visualizzare la query eseguita con il seguente filtro di log nel progetto correlato:

resource.type="bigquery_resource"
protoPayload.metadata.firstPartyAppMetadata.sheetsMetadata.docId != NULL_VALUE

Controlli di servizio VPC

Puoi utilizzare i Controlli di servizio VPC per limitare l'accesso alle risorseGoogle Cloud . Potresti non riuscire ad accedere ai dati BigQuery protetti da Controlli di servizio VPC, dato che questa funzionalità non supporta Fogli. Se hai le autorizzazioni di accesso necessarie e soddisfi le limitazioni di accesso di Controlli di servizio VPC, puoi configurare il perimetro Controlli di servizio VPC per consentire le query inviate tramite fogli connessi. Per farlo, devi configurare il perimetro utilizzando:

• Un livello di accesso o una regola in entrata per consentire le richieste provenienti da indirizzi IP, identità e dispositivi client attendibili dall'esterno del perimetro.
• Una regola in uscita per consentire la copia dei risultati delle query nei fogli di lavoro degli utenti.

Scopri di più sulla configurazione delle policy in entrata e in uscita e sulla configurazione dei livelli di accesso per configurare correttamente le regole. Per configurare un perimetro in modo da consentire la copia dei dati richiesta, utilizza il seguente file YAML:

- egressTo:
    operations:
    - serviceName: 'bigquery.googleapis.com'
      methodSelectors:
      - permission: 'bigquery.vpcsc.importData'
    resources:
    - projects/628550087766 # Sheets-owned Google Cloud project
  egressFrom:
    identityType: ANY_USER_ACCOUNT

Nota: gli aggiornamenti pianificati di fogli connessi non propagano alcun contesto dell'utente finale, ad esempio l'indirizzo IP o le informazioni del dispositivo. I perimetri dei Controlli di servizio VPC che utilizzano il contesto dell'utente finale per limitare l'accesso causano errori degli aggiornamenti pianificati.

Prima di iniziare

Se non hai un progetto Google Cloud configurato per la fatturazione, segui questi passaggi:

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. BigQuery viene abilitato automaticamente nei nuovi progetti. Per attivare BigQuery in un progetto preesistente, vai a

   Abilita l'API BigQuery, se non è già abilitata.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

   Abilitare l'API

Per evitare l'addebito di ulteriori costi, puoi eliminare le risorse che hai creato. Per maggiori dettagli, vedi Esegui la pulizia.

Apri i dati di BigQuery in Fogli connessi

Puoi aprire set di dati, tabelle e query salvate in Fogli connessi.

Dataset aperti

L'esempio seguente utilizza un set di dati pubblico per mostrare come connettersi a BigQuery da Fogli Google:

1. Crea o apri un foglio di lavoro di Fogli Google.

2. Fai clic su Dati, poi su Connettori dati e infine su Connetti a BigQuery.

   Nota: se non vedi l'opzione Connettori dati, consulta la sezione Prima di iniziare.

3. Seleziona un progetto Google Cloud per cui è abilitata la fatturazione.

4. Fai clic su Set di dati pubblici.

5. Nella casella di ricerca, digita chicago e poi seleziona il set di dati chicago_taxi_trips.

6. Seleziona la tabella taxi_trips e poi fai clic su Connetti.

   

   Il foglio di lavoro dovrebbe essere simile al seguente:

   

Inizia a utilizzare il foglio di lavoro. Puoi creare tabelle pivot, formule, grafici, colonne calcolate e query pianificate utilizzando le tecniche di Fogli Google che già conosci. Per saperne di più, consulta il tutorial su Fogli connessi.

Anche se il foglio di lavoro mostra un'anteprima di sole 500 righe, le tabelle pivot, le formule e i grafici utilizzano l'intero set di dati. Il numero massimo di righe per i risultati restituiti per le tabelle pivot è 200.000.

Puoi anche estrarre i dati in un foglio Google. Il numero massimo di righe e celle per i risultati restituiti per l'estrazione dati dipende dalle seguenti condizioni:

• Se il numero di righe è minore o uguale a 50.000, non è previsto alcun limite di celle.
• Se il numero di righe è maggiore di 50.000, ma minore o uguale a 500.000, il numero di celle deve essere minore o uguale a 5 milioni.
• Se il numero di righe è superiore a 500.000, il pull dei dati non è supportato.

Quando utilizzi Fogli connessi per creare un grafico, una tabella pivot, una formula o un'altra cella calcolata dai tuoi dati, Fogli connessi esegue una query in BigQuery per tuo conto. Per visualizzare questa query, segui questi passaggi:

1. Seleziona la cella o il grafico che hai creato.
2. Tieni il puntatore su Aggiorna.
3. (Facoltativo) Per aggiornare i risultati della query in fogli connessi, fai clic su Aggiorna.

4. Per visualizzare la query in BigQuery, fai clic su Dettagli delle query su BigQuery.

   La query si apre nella console Google Cloud .

Tabelle aperte

Per aprire una tabella in Fogli connessi, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

   Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro sinistro per aprirlo.

3. Nel riquadro Explorer, espandi il progetto, fai clic su Set di dati, quindi sul set di dati contenente la tabella che vuoi aprire in Fogli Google.

4. Fai clic su Panoramica > Tabelle e, accanto al nome della tabella, fai clic su Visualizza azioni, quindi seleziona Apri in > Fogli connessi.

Apri le query salvate

Assicurati di avere una query salvata. Per saperne di più, consulta Crea query salvate.

Per aprire una query salvata in Fogli connessi, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

3. Nel riquadro Explorer, espandi il progetto e fai clic su Query. Trova la query salvata che vuoi aprire in Fogli connessi.

4. Fai clic su Apri azioni accanto alla query salvata, quindi su Apri in > fogli connessi.

   In alternativa, fai clic sul nome della query salvata per aprirla nel riquadro dei dettagli, quindi fai clic su Apri in > Fogli connessi.

Utilizza l'analisi conversazionale in Fogli connessi

Puoi utilizzare l'analisi conversazionale in Fogli connessi per porre domande sui tuoi dati BigQuery e analizzarli utilizzando il linguaggio naturale. Gemini traduce le tue domande in query SQL ottimizzate, le esegue e riassume le tendenze principali, consentendoti di inserire oggetti di database attivi e aggiornabili direttamente nella tua cartella di lavoro.

Per analizzare i dati e creare oggetti di database in fogli connessi, completa i seguenti passaggi:

1. Apri il riquadro laterale di Gemini.

   Al primo utilizzo dell'analisi conversazionale, potresti visualizzare un messaggio che ti chiede di autorizzare l'accesso a BigQuery. Per continuare, fai clic su Connettiti.

2. Inserisci la domanda nel campo di testo. Puoi mantenere il contesto tra più domande.

3. Chiedi a Gemini di creare oggetti dinamici e aggiornabili.

4. Per aggiungere i risultati direttamente al foglio di lavoro, fai clic su Inserisci. Puoi aggiornare gli oggetti manualmente in qualsiasi momento o pianificare un aggiornamento.

Prepara i dati per l'analisi

Puoi ordinare e filtrare miliardi di righe di dati BigQuery direttamente in Fogli Google per semplificare il lavoro. Fai clic sull'icona Filtro nella parte superiore di una colonna per ordinare i dati o applicare filtri in base a condizione e valore. Per saperne di più, consulta Ordina e filtra i dati BigQuery in Fogli Google.

Per rendere i dati più leggibili senza modificare lo schema BigQuery sottostante, puoi assegnare nomi personalizzati (alias) alle intestazioni delle colonne. Per configurare un alias:

1. Nella parte superiore della colonna che vuoi rinominare, fai clic sulla freccia rivolta verso il basso.
2. Seleziona Rinomina colonna con alias.
3. Inserisci il nuovo nome.
4. Fai clic su Salva.

Non puoi assegnare un alias alle colonne calcolate e qualsiasi alias creato viene mantenuto solo all'interno di una singola connessione BigQuery in una singella cartella di lavoro. Per saperne di più, consulta Inizia a utilizzare i dati BigQuery in Fogli Google.

Analizza i dati in Fogli connessi

Puoi eseguire un'analisi approfondita dei dati di BigQuery utilizzando gli strumenti di Fogli Google che già conosci. Puoi creare grafici, creare tabelle pivot che supportano fino a 100.000 risultati e applicare le funzioni dei fogli di lavoro supportate per riepilogare il set di dati. Puoi anche estrarre fino a 500.000 righe o 10 MB di dati BigQuery per l'analisi offline.

Per saperne di più, consulta Analizza e aggiorna i dati BigQuery in Fogli Google.

Scrivi una query personalizzata in Fogli connessi

Per eseguire analisi più complesse, ad esempio l'unione di dati da più tabelle BigQuery, puoi scrivere query GoogleSQL personalizzate direttamente in Fogli connessi.

Per scrivere una query, segui questi passaggi:

1. Fai clic su Query salvate > Editor di query.
2. Inserisci la query. Puoi configurare i parametri in modo che utilizzino il valore di celle specifiche del foglio di lavoro all'interno della query.
3. Fai clic su Inserisci risultati.

Per saperne di più e visualizzare query di esempio, consulta Scrivere e modificare una query.

Monitora l'utilizzo di BigQuery da Fogli connessi

In qualità di amministratore di BigQuery, puoi monitorare e controllare il consumo delle risorse da Fogli connessi per comprendere i pattern di utilizzo, gestire i costi e identificare i report utilizzati di frequente. Le sezioni seguenti forniscono query SQL di esempio per aiutarti a monitorare questo utilizzo sia a livello di organizzazione che di progetto. Per saperne di più, consulta la vista JOBS.

A tutte le query provenienti da fogli connessi viene assegnato un prefisso ID job univoco: sheets_dataconnector. Puoi utilizzare questo prefisso per filtrare i job nelle visualizzazioni INFORMATION_SCHEMA.JOBS.

Aggrega l'utilizzo di Fogli connessi per utente a livello di organizzazione

La seguente query fornisce un riepilogo dei principali utenti di fogli connessi nella tua organizzazione negli ultimi 30 giorni, classificati in base ai dati fatturati totali. La query aggrega il numero totale di query, i byte totali fatturati e i millisecondi di slot totali per ogni utente. Queste informazioni sono utili per comprendere l'adozione e identificare i principali consumatori di risorse.

SELECT
  user_email,
  COUNT(*) AS total_queries,
  SUM(total_bytes_billed) AS total_bytes_billed,
  SUM(total_slot_ms) AS total_slot_ms
FROM
  `region-REGION_NAME.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION`
WHERE
  -- Filter for jobs created in the last 30 days
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  -- Filter for jobs originating from Connected Sheets
  AND job_id LIKE 'sheets_dataconnector%'
  -- Filter for completed jobs
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
GROUP BY
  1
ORDER BY
  total_bytes_billed DESC;

Sostituisci REGION_NAME con la regione del tuo progetto. Ad esempio, region-us.

Nota: devi utilizzare un qualificatore di regione per eseguire query sulle viste INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della vista INFORMATION_SCHEMA.

Il risultato è simile al seguente:

+---------------------+---------------+--------------------+-----------------+
| user_email          | total_queries | total_bytes_billed | total_slot_ms   |
+---------------------+---------------+--------------------+-----------------+
| [e-mail]   | 152           | 12000000000        | 3500000         |
| [e-mail]     | 45            | 8500000000         | 2100000         |
| [e-mail] | 210           | 1100000000         | 1800000         |
+---------------------+---------------+--------------------+-----------------+

Trova i log dei job delle query di Fogli connessi a livello di organizzazione

La seguente query fornisce un log dettagliato di ogni singolo job eseguito da Fogli connessi. Queste informazioni sono utili per l'audit e l'identificazione di query specifiche con costi elevati.

SELECT
  job_id,
  creation_time,
  user_email,
  project_id,
  total_bytes_billed,
  total_slot_ms
FROM
  `region-REGION_NAME.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION`
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  AND job_id LIKE 'sheets_dataconnector%'
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
ORDER BY
  creation_time DESC;

Sostituisci REGION_NAME con la regione del tuo progetto. Ad esempio, region-us.

Nota: devi utilizzare un qualificatore di regione per eseguire query sulle viste INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della vista INFORMATION_SCHEMA.

Il risultato è simile al seguente:

+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+
| job_id                          | creation_time                   | user_email      | project_id | total_bytes_billed | total_slot_ms |
+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+
| sheets_dataconnector_bquxjob_1  | 2025-11-06 00:26:53.077000 UTC  | [e-mail] | my_project | 12000000000        | 3500000       |
| sheets_dataconnector_bquxjob_2  | 2025-11-06 00:24:04.294000 UTC  | [e-mail] | my_project | 8500000000         | 2100000       |
| sheets_dataconnector_bquxjob_3  | 2025-11-03 23:17:25.975000 UTC  | [e-mail] | my_project | 1100000000         | 1800000       |
+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+

### Aggrega l'utilizzo di Fogli connessi per utente a livello di progetto

Se non disponi delle autorizzazioni a livello di organizzazione o devi monitorare solo un progetto specifico, esegui la seguente query per identificare i principali utenti di Fogli connessi all'interno di un progetto negli ultimi 30 giorni. La query aggrega il numero totale di query, i byte totali fatturati e i millisecondi di slot totali per ogni utente. Queste informazioni sono utili per comprendere l'adozione e identificare i principali consumatori di risorse.

SELECT
  user_email,
  COUNT(*) AS total_queries,
  SUM(total_bytes_billed) AS total_bytes_billed,
  SUM(total_slot_ms) AS total_slot_ms
FROM
  -- This view queries the project you are currently running the query in.
  `region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_BY_PROJECT
WHERE
  -- Filter for jobs created in the last 30 days
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  -- Filter for jobs originating from Connected Sheets
  AND job_id LIKE 'sheets_dataconnector%'
  -- Filter for completed jobs
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
GROUP BY
  user_email
ORDER BY
  total_bytes_billed DESC
LIMIT
  10;

Sostituisci REGION_NAME con la regione del tuo progetto. Ad esempio, region-us.

Nota: devi utilizzare un qualificatore di regione per eseguire query sulle viste INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della vista INFORMATION_SCHEMA.

Il risultato è simile al seguente:

+---------------------+---------------+--------------------+-----------------+
| user_email          | total_queries | total_bytes_billed | total_slot_ms   |
+---------------------+---------------+--------------------+-----------------+
| [e-mail]   | 152           | 12000000000        | 3500000         |
| [e-mail]     | 45            | 8500000000         | 2100000         |
| [e-mail] | 210           | 1100000000         | 1800000         |
+---------------------+---------------+--------------------+-----------------+

### Trova i log dei job delle query di Fogli connessi a livello di progetto Per trovare i log dei job delle query di Fogli connessi a livello di progetto:

Se non disponi delle autorizzazioni a livello di organizzazione o devi monitorare solo un progetto specifico, esegui la seguente query per visualizzare un log dettagliato di tutte le query di fogli connessi per il progetto corrente:

SELECT
  job_id,
  creation_time,
  user_email,
  total_bytes_billed,
  total_slot_ms,
  query
FROM
  -- This view queries the project you are currently running the query in.
  `region-REGION_NAME.INFORMATION_SCHEMA.JOBS_BY_PROJECT`
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  AND job_id LIKE 'sheets_dataconnector%'
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
ORDER BY
  creation_time DESC;

Sostituisci REGION_NAME con la regione del tuo progetto. Ad esempio, region-us.

Nota: devi utilizzare un qualificatore di regione per eseguire query sulle viste INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della vista INFORMATION_SCHEMA.

Il risultato è simile al seguente:

+---------------------------------+---------------------------------+------------------+--------------------+-----------------+---------------------------------+
| job_id                          | creation_time                   | user_email       | total_bytes_billed | total_slot_ms   |  query                          |
+---------------------------------+---------------------------------+------------------+--------------------+-----------------+---------------------------------+
| sheets_dataconnector_bquxjob_1  | 2025-11-06 00:26:53.077000 UTC  | [e-mail]  | 12000000000        | 3500000         |  SELECT ... FROM dataset.table1 |
| sheets_dataconnector_bquxjob_2  | 2025-11-06 00:24:04.294000 UTC  | [e-mail]  | 8500000000         | 2100000         |  SELECT ... FROM dataset.table2 |
| sheets_dataconnector_bquxjob_3  | 2025-11-03 23:17:25.975000 UTC  | [e-mail]  | 1100000000         | 1800000         |  SELECT ... FROM dataset.table3 |
+---------------------------------+---------------------------------+------------------+--------------------+-----------------+---------------------------------+

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud , vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Inizia a utilizzare i dati BigQuery in Fogli Google.
• Guarda i video della playlist sull'utilizzo di Fogli connessi.
• Completa il lab Fogli connessi: Qwik Start.
• Completa il lab Esame dei dati di fatturazione di BigQuery in Fogli Google.
• Ottieni lo badge delle competenze Analizza i dati di BigQuery in Fogli connessi.