Introduzione a SQL in BigQuery
Questo documento fornisce una panoramica delle istruzioni e dei dialetti SQL supportati in BigQuery.
GoogleSQL è un Structured Query Language (SQL) conforme allo standard ANSI che include i seguenti tipi di istruzioni supportate:
- Le istruzioni di query, note anche come istruzioni Data Query Language (DQL), sono il metodo principale per analizzare i dati in BigQuery. Scansionano una o più tabelle o espressioni e restituiscono le righe di risultati calcolati. Le istruzioni di query possono includere la sintassi pipe.
- Le istruzioni del linguaggio procedurale sono estensioni procedurali di GoogleSQL che consentono di eseguire più istruzioni SQL in un'unica richiesta. Le istruzioni procedurali possono utilizzare variabili e istruzioni di controllo del flusso e possono avere effetti collaterali.
Le istruzioni Data Definition Language (DDL) consentono di creare e modificare oggetti come:
- Set di dati
- Tabelle, inclusi schema e tipi di colonne
- Cloni e snapshot delle tabelle
- Visualizzazioni
- Funzioni
- Indici
- Impegni di capacità, prenotazioni e assegnazioni
- Policy di accesso a livello di riga
Le istruzioni Data Manipulation Language (DML) consentono di aggiornare, inserire ed eliminare dati dalle tabelle BigQuery.
Le istruzioni Data Control Language (DCL) consentono di controllare le risorse di sistema BigQuery, come l'accesso e la capacità.
Le istruzioni Transaction Control Language (TCL) consentono di gestire le transazioni per le modifiche ai dati.
Carica estratti conto ed esporta estratti conto per gestire i dati in entrata e in uscita da BigQuery.
Dialetti SQL BigQuery
BigQuery supporta il dialetto GoogleSQL, ma è disponibile anche un dialetto SQL precedente. Se non hai mai utilizzato BigQuery, ti consigliamo di utilizzare GoogleSQL, in quanto supporta la più ampia gamma di funzionalità. Ad esempio, funzionalità come le istruzioni DDL e DML sono supportate solo utilizzando GoogleSQL. SQL legacy viene mantenuto per la compatibilità con le versioni precedenti e consigliamo ai clienti di eseguire la migrazione se utilizzaSQL precedenteacy.
Passare dal dialetto predefinito
L'interfaccia che utilizzi per eseguire query sui dati determina il dialetto di query predefinito. Per passare a un altro dialetto:
Console
Il dialetto predefinito per la console Google Cloud è GoogleSQL. Per modificare il dialetto in SQL precedente:
Nella console Google Cloud , vai alla pagina BigQuery.
Nell'editor di query, fai clic sul pulsante Altro > Impostazioni query.
Nella sezione Opzioni avanzate, per Dialetto SQL, fai clic su Legacy, quindi su Salva. Imposta l'opzione SQL precedente per questa query. Quando fai clic su add_box Query SQL per creare una nuova query, devi selezionare di nuovo l'opzione SQL precedente.
SQL
Il dialetto SQL predefinito è GoogleSQL.
Puoi impostare il dialetto SQL includendo il prefisso
#standardSQL
o #legacySQL
come parte della query.
Questi prefissi di query non sono sensibili alle maiuscole, devono precedere la query e
devono essere separati dalla query da un carattere di nuova riga. L'esempio
seguente imposta il dialetto su SQL precedente ed esegue query sul set di dati sulla natalità:
Nella console Google Cloud , vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
#legacySQL SELECT weight_pounds, state, year, gestation_weeks FROM [bigquery-public-data:samples.natality] ORDER BY weight_pounds DESC LIMIT 10;
Fai clic su
Esegui.
Per maggiori informazioni su come eseguire le query, consulta Eseguire una query interattiva.
bq
Il dialetto di query predefinito nello strumento a riga di comando bq
è SQL precedente. Per
passare al dialetto GoogleSQL, aggiungi il flag --use_legacy_sql=false
o
--nouse_legacy_sql
all'istruzione della riga di comando.
Passare al dialetto GoogleSQL
Per utilizzare la sintassi GoogleSQL in un job di query, imposta il parametro use_legacy_sql
su false
.
bq query \
--use_legacy_sql=false \
'SELECT
word
FROM
`bigquery-public-data.samples.shakespeare`'
Impostare GoogleSQL come dialetto predefinito
Puoi impostare GoogleSQL come dialetto predefinito per lo strumento a riga di comando e per la shell interattiva modificando il file di configurazione dello strumento a riga di comando:.bigqueryrc
.
Per ulteriori informazioni su .bigqueryrc
, vedi
Impostazione dei valori predefiniti per i flag specifici dei comandi.
Per impostare --use_legacy_sql=false
in .bigqueryrc
:
- Apri
.bigqueryrc
in un editor di testo. Per impostazione predefinita,.bigqueryrc
deve trovarsi nella directory utente, ad esempio$HOME/.bigqueryrc
. Aggiungi il seguente testo al file. Questo esempio imposta GoogleSQL come sintassi predefinita per le query e per il comando
mk
(utilizzato quando crei una vista). Se hai già configurato i valori predefiniti per i flag dei comandiquery
omk
, non devi aggiungere di nuovo[query]
o[mk]
.[query] --use_legacy_sql=false [mk] --use_legacy_sql=false
Salva e chiudi il file.
Se utilizzi la shell interattiva, devi uscire e riavviare per applicare le modifiche.
Per informazioni sui flag della riga di comando disponibili, consulta il riferimento allo strumento a riga di comando bq.
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery C#.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Per impostazione predefinita, la libreria C# utilizza GoogleSQL.Passa al dialetto SQL precedente
Per utilizzare la sintassi SQL precedente in un job di query, imposta il parametro UseLegacySql
su true
.
Vai
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Go.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Per impostazione predefinita, la libreria client Go utilizza GoogleSQL.Passa al dialetto SQL precedente
Per utilizzare la sintassi SQL precedente in un job di query, imposta la proprietà UseLegacySQL
all'interno della configurazione della query su true
.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Java.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Per impostazione predefinita, la libreria client Java utilizza GoogleSQL.Passa al dialetto SQL precedente
Per utilizzare la sintassi SQL precedente in un job di query, imposta il parametro useLegacySql
su true
.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Node.js.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Per impostazione predefinita, la libreria client Node.js utilizza GoogleSQL.Passa al dialetto SQL precedente
Per utilizzare la sintassi SQL precedente in un job di query, imposta il parametro useLegacySql
su true
.
PHP
Prima di provare questo esempio, segui le istruzioni di configurazione di PHP nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery PHP.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Per impostazione predefinita, la libreria client PHP utilizza GoogleSQL.Passa al dialetto SQL precedente
Per utilizzare la sintassi SQL precedente in un job di query, imposta il parametro useLegacySql
su true
.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Python.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Per impostazione predefinita, la libreria client Python utilizza GoogleSQL.Passa al dialetto SQL precedente
Per utilizzare la sintassi SQL precedente in un job di query, imposta il parametro use_legacy_sql
su True
.
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Ruby.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Per impostazione predefinita, la libreria client Ruby utilizza GoogleSQL.Passa al dialetto SQL precedente
Per utilizzare la sintassi SQL precedente in un job di query, passa l'opzione legacy_sql: true
con la query.
Passaggi successivi
- Per informazioni su come eseguire una query SQL in BigQuery, consulta Esecuzione di job di query interattivi e batch.
- Per ulteriori informazioni sull'ottimizzazione delle query in generale, consulta Introduzione all'ottimizzazione del rendimento delle query.
- Per informazioni sulla sintassi GoogleSQL utilizzata per eseguire query sui dati in BigQuery, consulta Sintassi delle query.
- Per scoprire di più su come utilizzare la sintassi della barra verticale nelle query, consulta la sezione Sintassi della barra verticale.