Esportare i risultati delle query in un file

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

Scaricare i risultati delle query in un file locale

Il download dei risultati delle 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 Cloud de Confiance console:

  1. Nella Cloud de Confiance console, apri la pagina BigQuery.

    Vai a BigQuery

  2. Fai clic su Query SQL.

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

  4. (Facoltativo) Per modificare la località di elaborazione, fai clic su Modifica > Impostazioni query. In 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 località in cui vuoi salvare i risultati.

    Il file viene scaricato nella località di download predefinita del browser.

Salvare i risultati delle query su Google Drive

Il salvataggio dei risultati delle 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 è dovuto al fatto che l'API Drive SDK non è in grado di accedere a Google Workspace. Per risolvere il problema, devi consentire al tuo account utente di accedere a Google Drive con l'API Drive SDK.

Per salvare i risultati delle query su Google Drive, utilizza la Cloud de Confiance console:

  1. Nella Cloud de Confiance console, apri la pagina BigQuery.

    Vai a BigQuery

  2. Fai clic su Query SQL.

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

  4. Fai clic su Esegui.

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

  6. In Google Drive, seleziona CSV o JSON. Quando salvi i risultati su Google Drive, non puoi scegliere la località. I risultati vengono sempre salvati nella località principale "Il mio Drive".

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

  8. Nel messaggio 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 è dovuto al fatto che l'API Drive SDK non è in grado di accedere a Google Workspace. Per risolvere il problema, devi consentire al tuo account utente di accedere a Fogli Google con l'API Drive SDK.

Per salvare i risultati delle query in Fogli Google, utilizza la Cloud de Confiance console:

  1. Nella Cloud de Confiance console, apri la pagina BigQuery.

    Vai a BigQuery

  2. Fai clic su Query SQL.

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

  4. (Facoltativo) Per modificare la località di elaborazione, fai clic su Modifica > Impostazioni query. In 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 di BigQuery sono stati collegati al tuo account utente. L'email contiene informazioni sulle autorizzazioni che hai concesso nonché i passaggi per rimuoverle.

  8. Quando i risultati vengono salvati, sotto i risultati della query nella Cloud de Confiance console viene visualizzato un messaggio simile al seguente: Saved to Sheets as "results-20190225-103531". 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 delle query in Fogli Google, il nome del file inizia con results-[DATE] dove [DATE] è la data odierna nel formato YYYYMMDD.

Risolvere i problemi relativi al salvataggio dei risultati in Fogli Google

Quando salvi i dati da BigQuery a Fogli Google, potresti notare che alcune celle dei fogli sono vuote. 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 stringa nella query GoogleSQL per dividere la colonna con i dati lunghi in due o più colonne, quindi salva di nuovo il risultato nei fogli.

Salvare i risultati delle query in Cloud Storage

Puoi esportare i risultati delle query in Cloud Storage nella Cloud de Confiance console seguendo questi passaggi:

  1. Apri la pagina BigQuery nella Cloud de Confiance console.

    Vai alla pagina BigQuery

  2. Fai clic su Query SQL.

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

  4. Fai clic su Esegui.

  5. Quando vengono restituiti i risultati, fai clic su Salva risultati > Cloud Storage.

  6. Nella finestra di dialogo Esporta in Google Cloud Storage:

    • In Località GCS, cerca il bucket, la cartella o il file in cui vuoi esportare i dati.
    • In Formato di esportazione, scegli il formato dei dati esportati: CSV, JSON (delimitato da nuova riga), Avro o Parquet.
    • In Compressione, seleziona un formato di compressione o seleziona None per nessuna compressione.

  7. Fai clic su Salva per esportare i risultati della query.

Per controllare l'avanzamento del job, espandi il riquadro Cronologia dei job e cerca il job con il tipo EXTRACT.

Limitare il download dei risultati delle query

Per impedire agli utenti di scaricare i risultati delle query dalla Cloud de Confiance console, utilizza uno dei seguenti metodi:

  • Configura un perimetro dei Controlli di servizio VPC per impedire l'esfiltrazione di dati. In questo modo, gli utenti non potranno scaricare ed esportare dati al di fuori dei limiti del perimetro stabiliti.

  • Contatta l'assistenza clienti Google Cloud per richiedere l'aggiunta del tuo Cloud de Confiance by S3NS progetto o della tua organizzazione a una lista limitata. In questo modo, le opzioni di download ed esportazione dei dati vengono disattivate direttamente nella Cloud de Confiance console.

Passaggi successivi