Recupero delle informazioni sulle viste
Questo documento descrive come elencare, ottenere informazioni e visualizzare i metadati per le viste in BigQuery.
Puoi elencare le viste nei set di dati:
- Utilizzo della console Google Cloud
- Utilizzo del comando
bq ls
nello strumento a riga di comando bq - Chiamata del metodo dell'API
tables.list
- Utilizzo delle librerie client
Prima di iniziare
Concedi i ruoli IAM (Identity and Access Management) che concedono agli utenti le autorizzazioni necessarie per eseguire ogni attività in questo documento.
Visualizzazioni elenco
La procedura per le visualizzazioni delle schede è identica a quella per le tabelle delle schede.
Autorizzazioni obbligatorie
Per elencare le visualizzazioni in un set di dati, devi disporre dell'autorizzazione IAM bigquery.tables.list
.
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per elencare le visualizzazioni in un set di dati:
roles/bigquery.user
roles/bigquery.metadataViewer
roles/bigquery.dataViewer
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
Per ulteriori informazioni sui ruoli e sulle autorizzazioni IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.
Elenca le visualizzazioni in un set di dati
Per elencare le visualizzazioni in un set di dati:
Console
Nel riquadro Spazio di esplorazione, espandi il progetto e seleziona un set di dati.
Scorri l'elenco per visualizzare le tabelle nel set di dati. Le tabelle e le visualizzazioni sono identificate da icone diverse.
SQL
Utilizza la visualizzazione INFORMATION_SCHEMA.VIEWS
:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
SELECT table_name FROM DATASET_ID.INFORMATION_SCHEMA.VIEWS;
Sostituisci
DATASET_ID
con il nome del set di dati.Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.
bq
Esegui il comando bq ls
. Il flag --format
può essere utilizzato per controllare l'output. Se elenchi le visualizzazioni in un progetto diverso da quello predefinito, aggiungi l'ID progetto al set di dati nel seguente formato:
project_id:dataset
.
bq ls --format=pretty project_id:dataset
Dove:
- project_id è l'ID progetto.
- dataset è il nome del set di dati.
Quando esegui il comando, il campo Type
mostra TABLE
o
VIEW
. Ad esempio:
+-------------------------+-------+----------------------+-------------------+ | tableId | Type | Labels | Time Partitioning | +-------------------------+-------+----------------------+-------------------+ | mytable | TABLE | department:shipping | | | myview | VIEW | | | +-------------------------+-------+----------------------+-------------------+
Esempi:
Inserisci il comando seguente per elencare le visualizzazioni nel set di dati mydataset
nel
progetto predefinito.
bq ls --format=pretty mydataset
Inserisci il seguente comando per elencare le visualizzazioni nel set di dati mydataset
in
myotherproject
.
bq ls --format=pretty myotherproject:mydataset
API
Per elencare le visualizzazioni utilizzando l'API, chiama il metodo tables.list
.
Vai
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Go.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Python.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Per recuperare i metadati della visualizzazione:
- Utilizzo della console Google Cloud
- Utilizzo del comando
bq show
dello strumento a riga di comando bq - Chiamata del metodo dell'API
tables.get
- Utilizzo delle librerie client
- Eseguire query sulle viste
INFORMATION_SCHEMA
Visualizzare le informazioni sulle visualizzazioni
Il recupero delle informazioni sulle viste è identico alla procedura per ottenere informazioni sulle tabelle.
Autorizzazioni obbligatorie
Per ottenere informazioni su una visualizzazione, devi disporre dell'autorizzazione IAM bigquery.tables.get
.
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per ottenere informazioni su una visualizzazione:
roles/bigquery.metadataViewer
roles/bigquery.dataViewer
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
Inoltre, se disponi dell'autorizzazione bigquery.datasets.create
, puoi ottenere informazioni sulle visualizzazioni nei set di dati che crei.
Per ulteriori informazioni sui ruoli e sulle autorizzazioni IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.
Per visualizzare le informazioni sulle visualizzazioni:
Console
Espandi il set di dati.
Fai clic sul nome della visualizzazione.
Fai clic su Dettagli. La scheda Dettagli mostra la descrizione della vista, le informazioni sulla vista e la query SQL che la definisce.
SQL
Esegui una query sulla
vista INFORMATION_SCHEMA.VIEWS
.
L'esempio seguente recupera tutte le colonne tranne check_option
,
che è prenotato per l'uso futuro. I metadati restituiti si riferiscono a tutte le visualizzazioni di
DATASET_ID nel progetto predefinito:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
SELECT * EXCEPT (check_option) FROM DATASET_ID.INFORMATION_SCHEMA.VIEWS;
Sostituisci
DATASET_ID
con il nome del set di dati.Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.
bq
Esegui il comando bq show
. Il flag --format
può essere utilizzato per controllare l'output. Se ricevi informazioni su una visualizzazione in un progetto diverso da quello predefinito, aggiungi l'ID progetto al set di dati nel seguente formato: [PROJECT_ID]:[DATASET]
.
bq show \ --format=prettyjson \ project_id:dataset.view
Dove:
- project_id è l'ID progetto.
- dataset è il nome del set di dati.
- view è il nome della visualizzazione.
Esempi:
Inserisci il seguente comando per visualizzare le informazioni su myview
nel set di dati mydataset
nel tuo progetto predefinito.
bq show --format=prettyjson mydataset.myview
Inserisci il seguente comando per visualizzare le informazioni su myview
nel set di dati mydataset
in myotherproject
.
bq show --format=prettyjson myotherproject:mydataset.myview
API
Chiama il metodo tables.get
e fornisci eventuali parametri pertinenti.
Vai
Prima di provare questo esempio, segui le istruzioni di configurazione Go riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Go.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione Java riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Java.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Node.js.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Python.
Per autenticarti in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Visualizza sicurezza
Per controllare l'accesso alle visualizzazioni in BigQuery, consulta Visualizzazioni autorizzate.
Passaggi successivi
- Per informazioni sulla creazione di viste, consulta Creare viste.
- Per informazioni sulla creazione di una vista autorizzata, consulta Creare viste autorizzate.
- Per saperne di più sulla gestione delle visualizzazioni, consulta Gestire le visualizzazioni.
- Per una panoramica di
INFORMATION_SCHEMA
, vai a Introduzione a BigQueryINFORMATION_SCHEMA
.