Utilizzo di Fogli connessi

Fogli connessi porta la scalabilità di BigQuery nell'interfaccia familiare di Fogli Google. Con Fogli connessi, puoi visualizzare l'anteprima dei dati BigQuery e utilizzarli in tabelle pivot, formule e grafici creati dall'intero set di dati.

Puoi anche:

• Collaborare con partner, analisti o altre parti interessate nell'interfaccia familiare di un foglio di lavoro.

• Garantire un'unica fonte attendibile per l'analisi dei dati senza ulteriori esportazioni di fogli di lavoro.

• Semplificare i flussi di lavoro per report e dashboard.

Fogli connessi esegue le query BigQuery per tuo conto quando viene richiesto 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 alcuni casi d'uso che mostrano come Fogli connessi ti consente di analizzare grandi quantità di dati all'interno di un foglio, senza la necessità di 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 ogni 10.000 clienti.

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

Controllo degli accessi

L'accesso diretto a tabelle e set di dati 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 l'analisi nel foglio e utilizzare altre funzionalità di Fogli Google, ma non potrà eseguire le seguenti azioni:

• Aggiornare manualmente i dati BigQuery nel foglio.
• Pianificare un aggiornamento dei dati nel foglio.

Quando filtri i dati in Fogli connessi, la query che invii a BigQuery viene aggiornata rispetto 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 Controlli di servizio VPC per limitare l'accesso a Google Cloud risorse. Potresti non riuscire ad accedere ai dati BigQuery protetti da Controlli di servizio VPC, dato che questa funzionalità non supporta Fogli. Se disponi delle autorizzazioni di autorizzazione richieste 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 quanto segue:

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

Scopri come configurare le policy in entrata e in uscita e configurare i 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:

# Allows egress to Sheets through the Connected Sheets feature
- 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 di Controlli di servizio VPC che utilizzano il contesto dell'utente finale per limitare l'accesso causano errori degli aggiornamenti pianificati.

Prima di iniziare

Innanzitutto, assicurati di soddisfare i requisiti per l'accesso ai dati BigQuery in Fogli, come descritto nella sezione "Che cosa ti serve" dell' argomento di Google Workspace Iniziare a utilizzare i dati BigQuery in Fogli Google.

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

Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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

Verify that billing is enabled for your Google Cloud project.

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

Verify that billing is enabled for your Google Cloud project.

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

   Abilita l'API BigQuery.

   Ruoli richiesti per abilitare le API

   Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), che contiene l'autorizzazione serviceusage.services.enable. 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.

Aprire i set di dati BigQuery da Fogli connessi

L'esempio seguente utilizza un set di dati pubblici per mostrarti come connetterti a BigQuery da Fogli Google:

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

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

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

3. Seleziona un Google Cloud progetto con la fatturazione abilitata.

4. Fai clic su Set di dati pubblici.

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

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

   

   Il foglio di lavoro dovrebbe avere un aspetto simile al seguente:

   

Inizia a utilizzare il foglio di lavoro. Puoi creare tabelle pivot, formule, grafici, colonne calcolate e query pianificate utilizzando le tecniche familiari di Fogli Google. Per ulteriori informazioni, consulta il tutorial di Fogli connessi.

Sebbene il foglio di lavoro mostri un'anteprima di sole 500 righe, tutte 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 di lavoro di Fogli Google. Il numero massimo di righe e celle per i risultati restituiti per le estrazioni di 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 è maggiore di 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:

1. Seleziona la cella o il grafico che hai creato.
2. Tieni il puntatore sopra 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 Google Cloud console.

Aprire le tabelle in Fogli connessi

Per aprire una tabella in Fogli connessi:

1. Nella Google Cloud console, 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 a sinistra per aprirlo.

3. Nel riquadro Spazio di esplorazione, espandi il progetto, fai clic su Set di dati e poi sul set di dati che contiene 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.

Aprire le query salvate in Fogli connessi

Assicurati di avere una query salvata. Per ulteriori informazioni, vedi Creare query salvate.

Per aprire una query salvata in Fogli connessi:

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

   Vai a BigQuery

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

   

3. Nel riquadro Spazio di esplorazione, 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 fai clic 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.

Monitorare l'utilizzo di BigQuery da Fogli connessi

In qualità di amministratore di BigQuery, puoi monitorare e controllare il consumo di 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 a livello di organizzazione e di progetto. Per ulteriori informazioni, vedi la visualizzazione 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.

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

La query seguente fornisce un riepilogo dei principali utenti di Fogli connessi nella tua organizzazione negli ultimi 30 giorni, in base al totale dei dati fatturati. La query aggrega il numero totale di query, il totale dei byte fatturati e il totale dei millisecondi di slot per ogni utente. Queste informazioni sono utili per comprendere l'adozione e per 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 visualizzazioni INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della visualizzazione 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         |
+---------------------+---------------+--------------------+-----------------+

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

La query seguente fornisce un log dettagliato di ogni singolo job eseguito da Fogli connessi. Queste informazioni sono utili per il controllo e l'identificazione di query specifiche ad alto costo.

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 visualizzazioni INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della visualizzazione 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       |
+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+

Aggregare 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 query seguente 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, il totale dei byte fatturati e il totale dei millisecondi di slot per ogni utente. Queste informazioni sono utili per comprendere l'adozione e per 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 visualizzazioni INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della visualizzazione 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         |
+---------------------+---------------+--------------------+-----------------+

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 query seguente 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 visualizzazioni INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della visualizzazione 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 |
+---------------------------------+---------------------------------+------------------+--------------------+-----------------+---------------------------------+

Pulizia

Per evitare che al tuo Google Cloud account 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 Google Cloud console, 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 e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Per ulteriori informazioni, consulta l'argomento di Google Workspace Iniziare a utilizzare i dati BigQuery in Fogli Google.

• Guarda i video della playlist Utilizzo di Fogli connessi su YouTube.