Esportare i risultati di una query in Blob Storage

Importante: il termine "BigLake" in questa pagina si riferisce a una funzionalità di delega dell'accesso per le tabelle esterne in BigQuery. Per informazioni su BigLake, il prodotto Google Cloud autonomo che include BigLake Metastore, il catalogo REST di Apache Iceberg e le tabelle BigLake per Apache Iceberg, consulta Panoramica di BigLake.

Questo documento descrive come esportare il risultato di una query eseguita su una tabella BigLake nel tuo spazio di archiviazione BLOB di Azure.

Per informazioni sul flusso di dati tra BigQuery e Azure Blob Storage, consulta Flusso di dati durante l'esportazione dei dati.

Limitazioni

Per un elenco completo delle limitazioni che si applicano alle tabelle BigLake in base ad Amazon S3 e Blob Storage, consulta Limitazioni.

Prima di iniziare

Assicurati di disporre delle seguenti risorse:

• Una connessione per accedere a Blob Storage. All'interno della connessione, devi creare un criterio per il percorso del container Blob Storage in cui vuoi eseguire l'esportazione. Poi, all'interno di questa norma, crea un ruolo che disponga dell'autorizzazione Microsoft.Storage/storageAccounts/blobServices/containers/write.
• Una tabella BigLake di Archiviazione blob.

• Se utilizzi il modello di determinazione dei prezzi basato sulla capacità, assicurati di aver abilitato l'API BigQuery Reservation per il tuo progetto. Per informazioni sui prezzi, consulta la pagina Prezzi di BigQuery Omni.

Esportare i risultati della query

BigQuery Omni scrive nella posizione di Blob Storage specificata indipendentemente dal contenuto esistente. La query di esportazione può sovrascrivere i dati esistenti o combinare il risultato della query con i dati esistenti. Ti consigliamo di esportare il risultato della query in un contenitore Blob Storage vuoto.

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

   Vai a BigQuery

2. Nel campo Editor di query, inserisci una query di esportazione GoogleSQL:

   EXPORT DATA WITH CONNECTION \`CONNECTION_REGION.CONNECTION_NAME\`
   OPTIONS(
     uri="azure://AZURE_STORAGE_ACCOUNT_NAME.blob.core.windows.net/CONTAINER_NAME/FILE_PATH/*",
     format="FORMAT"
   )
   AS QUERY

   Sostituisci quanto segue:

   • CONNECTION_REGION: la regione in cui è stata creata la connessione.
   • CONNECTION_NAME: il nome della connessione che hai creato con l'autorizzazione necessaria per scrivere nel container.
   • AZURE_STORAGE_ACCOUNT_NAME: il nome dell'account Blob Storage in cui vuoi scrivere il risultato della query.
   • CONTAINER_NAME: il nome del contenitore in cui vuoi scrivere il risultato della query.
   • FILE_PATH: il percorso in cui vuoi scrivere il file esportato. Deve contenere esattamente un carattere jolly * in qualsiasi punto della directory foglia della stringa di percorso, ad esempio ../aa/*, ../aa/b*c, ../aa/*bc e ../aa/bc*. BigQuery sostituisce * con 0000..N a seconda del numero di file esportati. BigQuery determina il conteggio e le dimensioni dei file. Se BigQuery decide di esportare due file, * nel nome del primo file viene sostituito da 000000000000 e * nel nome del secondo file viene sostituito da 000000000001.
   • FORMAT: i formati supportati sono JSON, AVRO, CSV e PARQUET.
   • QUERY: la query per analizzare i dati archiviati in una tabella BigLake.

Nota: per sostituire il progetto predefinito, utilizza il parametro --project_id=PROJECT_ID. Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud .

Risoluzione dei problemi

Se ricevi un errore relativo a quota failure, controlla se hai prenotato capacità per le tue query. Per ulteriori informazioni sulle prenotazioni di slot, consulta la sezione Prima di iniziare in questo documento.

Passaggi successivi

• Scopri di più su BigQuery Omni.
• Scopri come esportare i dati delle tabelle.
• Scopri come eseguire query sui dati archiviati in Blob Storage.
• Scopri come configurare i Controlli di servizio VPC per BigQuery Omni.