Guida rapida: utilizzo delle librerie client
Questa pagina mostra come iniziare a utilizzare l'API BigQuery nel tuo linguaggio di programmazione preferito.
Prima di iniziare
- Accedi al tuo account Google Cloud. 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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.
-
Attiva BigQuery API.
-
Crea un account di servizio:
-
Nella console Google Cloud, vai alla pagina Crea account di servizio.
Vai a Crea account di servizio - Seleziona il progetto.
-
Inserisci un nome nel campo Service account name (Nome account di servizio). La console Google Cloud compila il campo ID account di servizio in base a questo nome.
Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio:
Service account for quickstart
. - Fai clic su Crea e continua.
-
Per fornire l'accesso al progetto, concedi i seguenti ruoli al tuo account di servizio: Progetto > Proprietario.
Nell'elenco Seleziona un ruolo, seleziona un ruolo.
Per altri ruoli, fai clic su
Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo. - Fai clic su Continua.
-
Fai clic su Fine per completare la creazione dell'account di servizio.
Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.
-
-
Crea una chiave dell'account di servizio:
- Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
- Fai clic su Chiavi.
- Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
- Fai clic su Crea. Sul computer viene scaricato un file della chiave JSON.
- Fai clic su Chiudi.
-
Imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
sul percorso del file JSON che contiene la chiave dell'account di servizio. Questa variabile si applica solo alla sessione shell corrente, quindi se apri una nuova sessione, impostala di nuovo. -
Nella pagina del selettore dei progetti in Google Cloud Console, seleziona o crea un progetto Google Cloud.
-
Attiva BigQuery API.
-
Crea un account di servizio:
-
Nella console Google Cloud, vai alla pagina Crea account di servizio.
Vai a Crea account di servizio - Seleziona il progetto.
-
Inserisci un nome nel campo Service account name (Nome account di servizio). La console Google Cloud compila il campo ID account di servizio in base a questo nome.
Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio:
Service account for quickstart
. - Fai clic su Crea e continua.
-
Per fornire l'accesso al progetto, concedi i seguenti ruoli al tuo account di servizio: Progetto > Proprietario.
Nell'elenco Seleziona un ruolo, seleziona un ruolo.
Per altri ruoli, fai clic su
Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo. - Fai clic su Continua.
-
Fai clic su Fine per completare la creazione dell'account di servizio.
Non chiudere la finestra del browser. La utilizzerai nel passaggio successivo.
-
-
Crea una chiave dell'account di servizio:
- Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
- Fai clic su Chiavi.
- Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.
- Fai clic su Crea. Sul computer viene scaricato un file della chiave JSON.
- Fai clic su Chiudi.
-
Imposta la variabile di ambiente
GOOGLE_APPLICATION_CREDENTIALS
sul percorso del file JSON che contiene la chiave dell'account di servizio. Questa variabile si applica solo alla sessione shell corrente, quindi se apri una nuova sessione, impostala di nuovo.
Installa la libreria client
C#
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo C#, consulta la Guida alla configurazione dell'ambiente di sviluppo C#.
Install-Package Google.Cloud.BigQuery.V2 -Pre
Go
go mod init YOUR_MODULE_NAME go get cloud.google.com/go/bigquery
Java
Per saperne di più sulla configurazione del tuo ambiente di sviluppo Java, consulta la guida alla configurazione dell'ambiente di sviluppo Java.
Se utilizzi Maven, aggiungi quanto segue al file pom.xml
. Per ulteriori informazioni sui
BOM, consulta la pagina BOM delle librerie Google Cloud Platform.
Se utilizzi Gradle, aggiungi quanto segue alle dipendenze:
Se utilizzi sbt, aggiungi quanto segue alle dipendenze:
Se utilizzi Visual Studio Code, IntelliJ o Eclipse, puoi aggiungere librerie client al progetto utilizzando i seguenti plug-in IDE:
I plug-in offrono funzionalità aggiuntive, come la gestione delle chiavi per gli account di servizio. Per informazioni dettagliate, consulta la documentazione di ogni plug-in.
Node.js
Per saperne di più sulla configurazione dell'ambiente di sviluppo Node.js, consulta la Guida alla configurazione dell'ambiente di sviluppo Node.js.
npm install --save @google-cloud/bigquery
PHP
composer require google/cloud-bigquery
Python
Per saperne di più sulla configurazione dell'ambiente di sviluppo Python, consulta la guida alla configurazione dell'ambiente di sviluppo Python.
pip install --upgrade google-cloud-bigquery
Ruby
Per saperne di più sulla configurazione dell'ambiente di sviluppo Ruby, consulta la Guida alla configurazione dell'ambiente di sviluppo Ruby.
gem install google-cloud-bigquery
Importa le librerie
C#
Per saperne di più, consulta la documentazione di riferimento dell'API C# BigQuery.
Go
Per saperne di più, consulta la documentazione di riferimento dell'API Go BigQuery.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Java BigQuery.
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Node.js BigQuery.
PHP
Per saperne di più, consulta la documentazione di riferimento dell'API PHP BigQuery.
Python
Per saperne di più, consulta la documentazione di riferimento dell'API Python BigQuery.
Ruby
Per saperne di più, consulta la documentazione di riferimento dell'API Ruby BigQuery.
Inizializza un client BigQuery
Inizializza un client per autenticarti e connetterti all'API BigQuery.
C#
Utilizza la funzione BigQueryClient.Create() per creare il client BigQuery.
Go
Utilizza la funzione bigquery.NewClient() per creare il client BigQuery.
Java
Utilizza la funzione BigQueryOptions.getDefaultInstance() per utilizzare le opzioni di autenticazione predefinite. Utilizza la funzione BigQueryOptions.getService() per creare il client BigQuery.
Node.js
Crea un'istanza della classe BigQuery per creare il client BigQuery.
PHP
Crea un'istanza della classe BigQueryClient per creare il client BigQuery.
Python
Crea un'istanza della classe bigquery.Client per creare il client BigQuery.
Ruby
Utilizza la funzione Google::Cloud::Bigquery.new per creare il client BigQuery.
Esegui una query su un set di dati
La seguente query recupera le domande più viste con tag google-bigquery
dal set di dati pubblico Stack Overflow.
SELECT CONCAT( 'https://stackoverflow.com/questions/', CAST(id as STRING)) as url, view_count FROM `bigquery-public-data.stackoverflow.posts_questions` WHERE tags like '%google-bigquery%' ORDER BY view_count DESC LIMIT 10
Questa query utilizza la sintassi SQL standard di Google. Per impostazione predefinita, le librerie client utilizzano la sintassi SQL standard di Google. Per modificare il dialetto SQL, vedi Dialetti SQL BigQuery.
Esegui la query
Esegui la query seguente utilizzando il client BigQuery autenticato.
C#
Definisci una stringa di query e utilizza la funzione client.ExecuteQuery() per inviare la query e ottenere i risultati.
Go
Utilizza la funzione bigquery.Query() per definire una query e Query.Read() per inviare la query e ottenere i risultati.
Java
Definisci la query con un'istanza QueryJobConfiguration. Avvia il job di query con il metodo BigQuery.create().
Node.js
Utilizza il metodo BigQuery.query() per avviare la query.
PHP
Crea una configurazione di query e utilizza il metodo BigQueryClient.startQuery() per avviare la query.
Python
Utilizza il metodo Client.query() per avviare la query.
Ruby
Utilizza la funzione Google::Cloud::Bigquery::Project.query per avviare una query e attendere i risultati.
Scopri di più sulle query:
- Panoramica dei dati delle query
- Come eseguire query interattive e batch
- Come scrivere i risultati delle query in una tabella permanente
Visualizza il risultato della query
Visualizza i risultati della query.
C#
Go
Utilizza la funzione RowIterator.Next() per caricare ogni riga in un puntatore struct.
Java
Ripeti le operazioni su QueryResponse per ottenere tutte le righe nei risultati. L'iteratore gestisce automaticamente l'impaginazione. Ogni FieldList espone le colonne in base a indice numerico o nome di colonna.
Node.js
I risultati delle query vengono restituiti come elenco di righe, dove ogni riga è un dizionario.
PHP
Chiama il metodo Job.queryResults() per attendere il completamento della query. Ogni riga nei risultati della query è una matrice associativa.
Python
Ripeti il comando sopra RowIterator per ottenere tutte le righe nei risultati. L'iteratore gestisce automaticamente l'impaginazione. Ogni Riga espone le colonne in base a indice numerico, nome della colonna o come attributi Python.
Ruby
La classe Google::Cloud::Bigquery::Data espone ogni riga come un hash.
Scopri di più sull'utilizzo delle tabelle in BigQuery:
Completa il codice sorgente
Di seguito è riportato il codice sorgente completo dell'esempio.
C#
Go
Java
Node.js
PHP
Python
Ruby
Com'è andata?
Passaggi successivi
Scopri di più sulle nostre librerie client dell'API BigQuery.