Crea visualizzazioni
Questo documento descrive come creare viste in BigQuery.
Puoi creare una vista in BigQuery nei seguenti modi:
- Utilizzo della console Google Cloud.
- Viene utilizzato il comando
bq mk
dello strumento a riga di comando bq. - Chiamata al metodo API
tables.insert
. - Utilizzare le librerie client.
- Inviare un'istruzione DDL (Data Definition Language)
di
CREATE VIEW
.
Visualizza limitazioni
Le viste BigQuery sono soggette alle seguenti limitazioni:
- Le visualizzazioni sono di sola lettura. Ad esempio, non puoi eseguire query che inseriscono, aggiornano o eliminano dati.
- Il set di dati che contiene la tua vista e il set di dati che contiene le tabelle a cui fa riferimento la vista devono trovarsi nella stessa località.
- Un riferimento all'interno di una vista deve essere qualificato con un set di dati. Il set di dati predefinito non influisce sul corpo di una vista.
- Non puoi utilizzare il metodo dell'API JSON
TableDataList
per recuperare i dati da una vista. Per ulteriori informazioni, consulta Tabledata: list. - Non puoi combinare query GoogleSQL e SQL precedente quando utilizzi le viste. Una query GoogleSQL non può fare riferimento a una vista definita con la sintassi SQL precedente.
- Non puoi fare riferimento ai parametri di query nelle viste.
- Gli schemi delle tabelle sottostanti vengono archiviati insieme alla vista al momento della sua creazione. Se le colonne vengono aggiunte, eliminate o modificate dopo la creazione della vista, lo schema segnalato non sarà preciso finché la vista non verrà aggiornata. Anche se lo schema riportato potrebbe non essere preciso, tutte le query inviate generano risultati accurati.
- Non puoi aggiornare automaticamente una vista SQL precedente alla sintassi GoogleSQL. Per modificare la query utilizzata per definire una vista, puoi utilizzare quanto segue:
- L'opzione Modifica query nella console Google Cloud
- Comando
bq update --view
nello strumento a riga di comando bq - Le librerie client di BigQuery
- I metodi dell'API update o patch.
- Non puoi includere una funzione definita dall'utente temporanea o una tabella temporanea nella query SQL che definisce una vista.
- Non puoi fare riferimento a una vista in una query della tabella con caratteri jolly.
Per informazioni su quote e limiti che si applicano alle viste, consulta Limiti di visualizzazione.
Prima di iniziare
Concedi ruoli IAM (Identity and Access Management) che concedono agli utenti le autorizzazioni necessarie per eseguire ogni attività in questo documento.
Autorizzazioni obbligatorie
Le viste vengono trattate come risorse della tabella in BigQuery, quindi per creare una vista sono necessarie le stesse autorizzazioni della creazione di una tabella. Devi inoltre disporre delle autorizzazioni per eseguire query su tutte le tabelle a cui fa riferimento la query SQL della vista.
Per creare una vista, devi disporre dell'autorizzazione IAM bigquery.tables.create
. Il ruolo IAM predefinito di roles/bigquery.dataEditor
include le autorizzazioni necessarie per creare una vista.
Inoltre, se disponi dell'autorizzazione bigquery.datasets.create
, puoi creare viste nei set di dati che crei. Per creare una vista per dati che non sono di tua proprietà, devi disporre dell'autorizzazione bigquery.tables.getData
per la tabella.
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.
Visualizza denominazione
Quando crei una vista in BigQuery, il suo nome deve essere univoco per ogni set di dati. Il nome della vista può:
- Contenere caratteri con un massimo di 1024 byte UTF-8 in totale.
- Contenere caratteri Unicode nelle categorie L (lettera), M (segno), N (numero), Pc (connettore, incluso il trattino basso), Pd (trattino), Zs (spazio). Per ulteriori informazioni, consulta Categoria generale.
Di seguito sono riportati tutti esempi di nomi di visualizzazioni validi:
view 01
, ग्राहक
, 00_お客様
, étudiant-01
.
Precisazioni:
- Per impostazione predefinita, i nomi delle tabelle sono sensibili alle maiuscole.
mytable
eMyTable
possono coesistere nello stesso set di dati, a meno che non facciano parte di un set di dati con la sensibilità alle maiuscole disattivata. - Alcuni nomi e prefissi dei nomi delle visualizzazioni sono riservati. Se ricevi un errore che indica che il nome o il prefisso della vista è riservato, seleziona un altro nome e riprova.
Se includi più operatori di punto (
.
) in una sequenza, gli operatori duplicati vengono eliminati in modo implicito.Ad esempio:
project_name....dataset_name..table_name
Diventa questo:
project_name.dataset_name.table_name
Crea una vista
Per creare una vista, puoi comporre una query SQL utilizzata per definire i dati
accessibili alla vista. La query SQL deve essere composta da un'istruzione SELECT
.
Altri tipi di istruzioni (ad esempio le istruzioni DML) e query con più istruzioni non sono consentiti nelle query di visualizzazione.
Per creare una vista:
Console
Dopo aver eseguito una query, fai clic sul pulsante Salva visualizzazione sopra la finestra dei risultati della query per salvare la query come una vista.
Nella finestra di dialogo Salva visualizzazione:
- In Nome progetto, seleziona un progetto in cui archiviare la vista.
- In Nome set di dati, scegli un set di dati in cui archiviare la vista. Il set di dati che contiene la tua vista e quello che contiene le tabelle a cui fa riferimento devono trovarsi nella stessa località.
- In Nome tabella, inserisci il nome della vista.
- Fai clic su Salva.
SQL
Utilizza
l'istruzione CREATE VIEW
.
L'esempio seguente crea una vista denominata usa_male_names
dal set di dati pubblico con i nomi degli Stati Uniti:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
CREATE VIEW mydataset.usa_male_names(name, number) AS ( SELECT name, number FROM
bigquery-public-data.usa_names.usa_1910_current
WHERE gender = 'M' ORDER BY number DESC );Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
bq
Utilizza il comando bq mk
con il flag --view
. Per le query GoogleSQL, aggiungi il flag --use_legacy_sql
e impostalo su false
. Alcuni
parametri facoltativi sono --add_tags
, --expiration
, --description
e
--label
. Per un elenco completo dei parametri, consulta la documentazione di riferimento sul comando bq mk
.
Se la query fa riferimento a risorse di funzione definita dall'utente dall'utente (UDF) esterne archiviate in Cloud Storage o in file locali, utilizza il flag --view_udf_resource
per specificare queste risorse. La segnalazione --view_udf_resource
non è mostrata qui. Per ulteriori informazioni sull'utilizzo delle funzioni definite dall'utente, consulta UDF.
Se stai creando una vista in un progetto diverso da quello predefinito, specifica l'ID progetto utilizzando il flag --project_id
.
bq mk \ --use_legacy_sql=false \ --view_udf_resource=PATH_TO_FILE \ --expiration=INTEGER \ --description="DESCRIPTION" \ --label=KEY_1:VALUE_1 \ --add_tags=KEY_2:VALUE_2[,...] \ --view='QUERY' \ --project_id=PROJECT_ID \ DATASET.VIEW
Sostituisci quanto segue:
PATH_TO_FILE
è l'URI o il percorso del file system locale di un file di codice da caricare e valutare immediatamente come risorsa UDF utilizzata dalla vista. Ripeti il flag per specificare più file.INTEGER
imposta la durata (in secondi) della vista. SeINTEGER
è0
, la visualizzazione non scade. Se non includi il flag--expiration
, BigQuery crea la vista con la durata predefinita della tabella del set di dati.DESCRIPTION
è una descrizione della visualizzazione tra virgolette.KEY_1:VALUE_1
è la coppia chiave-valore che rappresenta un'etichetta. Ripeti il flag--label
per specificare più etichette.KEY_2:VALUE_2
è la coppia chiave-valore che rappresenta un tag. Aggiungi più tag sotto lo stesso flag con virgole tra le coppie chiave:valore.QUERY
è una query valida.PROJECT_ID
è il tuo ID progetto (se non hai configurato un progetto predefinito).DATASET
è un set di dati nel tuo progetto.VIEW
è il nome della vista che vuoi creare.
Esempi:
Inserisci il comando seguente per creare una vista denominata myview
in
mydataset
nel tuo progetto predefinito. La scadenza è impostata su 3600 secondi (1 ora), la descrizione è impostata su This is my view
e l'etichetta è impostata su organization:development
. La query utilizzata per creare i dati delle query di vista dal set di dati pubblico Name Data USA.
bq mk \
--use_legacy_sql=false \
--expiration 3600 \
--description "This is my view" \
--label organization:development \
--view \
'SELECT
name,
number
FROM
`bigquery-public-data.usa_names.usa_1910_current`
WHERE
gender = "M"
ORDER BY
number DESC' \
mydataset.myview
Inserisci questo comando per creare una vista denominata myview
in
mydataset
in myotherproject
. La descrizione è impostata su This is my view
, l'etichetta è impostata su organization:development
e la scadenza della vista è impostata sulla scadenza predefinita della tabella del set di dati.
La query utilizzata per creare i dati delle query di vista dal set di dati pubblico Name Data USA.
bq mk \
--use_legacy_sql=false \
--description "This is my view" \
--label organization:development \
--project_id myotherproject \
--view \
'SELECT
name,
number
FROM
`bigquery-public-data.usa_names.usa_1910_current`
WHERE
gender = "M"
ORDER BY
number DESC' \
mydataset.myview
Dopo aver creato la vista, puoi aggiornarne la scadenza, la descrizione e le etichette. Per ulteriori informazioni, consulta la sezione Aggiornamento delle visualizzazioni.
Terraform
Utilizza la risorsa google_bigquery_table
.
Per eseguire l'autenticazione in BigQuery, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
L'esempio seguente crea una vista denominata myview
:
Per applicare la tua configurazione Terraform a un progetto Google Cloud, completa i passaggi nelle sezioni seguenti.
Prepara Cloud Shell
- Avvia Cloud Shell.
-
Imposta il progetto Google Cloud predefinito a cui vuoi applicare le configurazioni Terraform.
Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.
Prepara la directory
Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo principale).
-
In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome del file deve avere l'estensione
.tf
, ad esempiomain.tf
. In questo tutorial, il file è denominatomain.tf
.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.
Copia il codice campione nel nuovo oggetto
main.tf
.Facoltativamente, copia il codice da GitHub. Questa opzione è consigliata se lo snippet Terraform fa parte di una soluzione end-to-end.
- Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
- Salva le modifiche.
-
Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.
terraform init
Facoltativamente, per utilizzare la versione più recente del provider Google, includi l'opzione
-upgrade
:terraform init -upgrade
Applica le modifiche
-
Esamina la configurazione e verifica che le risorse che Terraform creerà o aggiornerà soddisfino le tue aspettative:
terraform plan
Apporta le correzioni necessarie alla configurazione.
-
Applica la configurazione Terraform eseguendo questo comando e inserendo
yes
al prompt:terraform apply
Attendi finché in Terraform non viene visualizzato il messaggio "Applicazione completata!".
- Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti che Terraform le abbia create o aggiornate.
API
Chiama il metodo tables.insert
con una risorsa di tabella che contiene una proprietà view
.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Go di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Java di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python di BigQuery.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Dopo aver creato la vista, esegui una query come su una tabella.
Visualizza sicurezza
Per controllare l'accesso alle viste in BigQuery, consulta Viste autorizzate.
Passaggi successivi
- Per informazioni sulla creazione di una vista autorizzata, consulta Creazione di viste autorizzate.
- Per informazioni su come ottenere i metadati delle viste, consulta Ottenere informazioni sulle viste.
- Per ulteriori informazioni sulla gestione delle visualizzazioni, consulta la sezione Gestione delle visualizzazioni.