Esportare i risultati della query in un file

Questo documento descrive come salvare i risultati delle query come file, ad esempio CSV o JSON.

Scaricare i risultati di query in un file locale

Il download dei risultati della query in un file locale non è supportato dallo strumento a riga di comando bq o dall'API.

Per scaricare i risultati delle query come file CSV o JSON delimitato da nuova riga, utilizza la console Google Cloud:

Console

1. Nella console Google Cloud, apri la pagina BigQuery.

   Vai a BigQuery

2. Fai clic su Crea nuova query.

3. Inserisci una query GoogleSQL valida nell'area di testo Editor query.

4. (Facoltativo) Per cambiare la località di elaborazione, fai clic su Altro e seleziona Impostazioni query. Per Data Location (Località dei dati), scegli la località dei dati.

5. Fai clic su Esegui.

6. Quando vengono restituiti i risultati, fai clic su Salva risultati e seleziona il formato o la posizione in cui vuoi salvarli.

   Il file viene scaricato nella posizione predefinita per i download del browser.

Salvare i risultati della query su Google Drive

Beta

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Il salvataggio dei risultati della query su Google Drive non è supportato dallo strumento a riga di comando bq o dall'API.

Potresti ricevere un errore quando provi a salvare i risultati di BigQuery su Google Drive. Questo errore si verifica perché l'API SDK di Drive non riesce ad accedere a Google Workspace. Per risolvere il problema, devi consentire al tuo account utente di accedere a Google Drive con l'API SDK Drive.

Per salvare i risultati della query su Google Drive, utilizza la console Google Cloud:

Console

1. Nella console Google Cloud, apri la pagina BigQuery.

   Vai a BigQuery

2. Inserisci una query GoogleSQL valida nell'area di testo Editor query.

3. Fai clic su Esegui.

4. Quando vengono restituiti i risultati, fai clic su Salva risultati.

   

5. Seleziona CSV (Google Drive) o JSON (Google Drive). Quando salvi i risultati su Google Drive, non puoi scegliere la posizione. I risultati vengono sempre salvati nella posizione principale "Il mio Drive".

6. Il salvataggio dei risultati su Google Drive potrebbe richiedere alcuni minuti. Quando i risultati vengono salvati, ricevi un messaggio della finestra di dialogo che include il nome del file: bq-results-[TIMESTAMP]-[RANDOM_CHARACTERS].[CSV or JSON].

   

7. Nel messaggio della finestra di dialogo, fai clic su Apri per aprire il file oppure vai su Google Drive e fai clic su Il mio Drive.

Salvare i risultati delle query in Fogli Google

Il salvataggio dei risultati delle query in Fogli Google non è supportato dallo strumento a riga di comando bq o dall'API.

Potresti ricevere un errore quando provi ad aprire i risultati di BigQuery da Fogli Google. Questo errore si verifica perché l'API SDK di Drive non riesce ad accedere a Google Workspace. Per risolvere il problema, devi consentire al tuo account utente di accedere a Fogli Google con l'API SDK Drive.

Per salvare i risultati della query in Fogli Google, utilizza la console Google Cloud:

Console

1. Nella console Google Cloud, apri la pagina BigQuery.

   Vai a BigQuery

2. Fai clic su Crea nuova query.

3. Inserisci una query GoogleSQL valida nell'area di testo Editor query.

4. (Facoltativo) Per cambiare la località di elaborazione, fai clic su Altro e seleziona Impostazioni query. Per Data Location (Località dei dati), scegli la località dei dati.

5. Fai clic su Esegui.

6. Quando vengono restituiti i risultati, fai clic su Salva risultati e seleziona Fogli Google.

7. Se necessario, segui le istruzioni per accedere al tuo account utente e fai clic su Consenti per concedere a BigQuery l'autorizzazione a scrivere i dati nella cartella MY Drive di Google Drive.

   Dopo aver seguito le istruzioni, dovresti ricevere un'email di conferma che gli strumenti client BigQuery sono stati collegati al tuo account utente. L'email contiene informazioni sulle autorizzazioni che hai concesso insieme alla procedura per rimuoverle.

8. Quando i risultati vengono salvati, viene visualizzato un messaggio simile al seguente sotto i risultati della query nella console Google Cloud: Saved to Sheets as "results-20190225-103531. Open. Fai clic sul link nel messaggio per visualizzare i risultati in Fogli Google oppure vai alla cartella My Drive e apri il file manualmente.

   Quando salvi i risultati della query in Fogli Google, il nome del file inizia con results-[DATE], dove [DATE] è la data odierna nel formato YYYYMMDD.

Nota: il salvataggio dei risultati in Fogli Google non è supportato dallo strumento a riga di comando bq o dall'API. Per saperne di più, consulta Utilizzare Fogli connessi.

Risolvere i problemi di esportazione dei file

Quando esporti i dati da BigQuery in Fogli Google, potresti trovare alcune celle vuote nei fogli. Questo accade quando i dati che stai scrivendo nella cella superano il limite di 50.000 caratteri di Fogli Google. Per risolvere il problema, utilizza una funzione di stringa nella query GoogleSQL per suddividere la colonna con i dati lunghi in due o più colonne, quindi salva di nuovo il risultato in Fogli.

Passaggi successivi

• Scopri come esportare una tabella in un file JSON tramite programmazione.
• Scopri di più sulle quote per i job di esportazione.
• Scopri di più sui prezzi dello spazio di archiviazione di BigQuery.