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:
-
In Cloud Console, vai alla pagina Crea account di servizio.
Vai a Crea account di servizio - Seleziona il progetto.
-
Inserisci un nome nel campo Nome account di servizio. Cloud Console 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 tuo progetto, concedi i seguenti ruoli al tuo account di servizio: Progetto > proprietario.
Nell'elenco Seleziona un ruolo, scegli un ruolo.
Per ulteriori 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:
- In Cloud Console, 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. Il file di una chiave JSON viene scaricato sul computer.
- 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:
-
In Cloud Console, vai alla pagina Crea account di servizio.
Vai a Crea account di servizio - Seleziona il progetto.
-
Inserisci un nome nel campo Nome account di servizio. Cloud Console 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 tuo progetto, concedi i seguenti ruoli al tuo account di servizio: Progetto > proprietario.
Nell'elenco Seleziona un ruolo, scegli un ruolo.
Per ulteriori 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:
- In Cloud Console, 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. Il file di una chiave JSON viene scaricato sul computer.
- 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 ulteriori informazioni 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 ulteriori informazioni 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 ulteriori informazioni 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 ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Ruby, consulta la Guida alla configurazione dell'ambiente di sviluppo Ruby.
gem install google-cloud-bigquery
Importare le librerie
C#
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# BigQuery.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Go.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di BigQuery.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di BigQuery.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP BigQuery.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python BigQuery.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API BigQuery Ruby.
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.
Eseguire query su un set di dati
La query seguente recupera le domande con più visualizzazioni contrassegnate con 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. Per impostazione predefinita, le librerie client utilizzano la sintassi SQL standard. Per modificare il dialetto SQL, vedi Dialetti SQL di 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 la funzione 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 della query e utilizza il metodo BigQueryClient.startQuery() per avviarla.
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 risultati di 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 strutturale.
Java
Esegui l'iterazione su QueryResponse per ottenere tutte le righe nei risultati. L'iteratore gestisce automaticamente l'impaginazione. Ogni FieldList espone le colonne in base a un indice numerico o a un nome di colonna.
Node.js
I risultati delle query vengono restituiti come elenco di righe, in cui ogni riga è un dizionario.
PHP
Chiama il metodo Job.queryResults() per attendere il completamento della query. Ogni riga nei risultati della query è un array associatovo.
Python
Esegui l'iterazione su 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 colonna o attributi Python.
Ruby
La classe Google::Cloud::Bigquery::Data espone ogni riga come un hash.
Scopri di più sull'utilizzo delle tabelle in BigQuery:
Codice sorgente completo
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 librerie client delle API BigQuery.