Recupero delle informazioni sulle viste
Questo documento descrive come elencare, ottenere informazioni e visualizzare i metadati per in BigQuery.
Puoi elencare le visualizzazioni nei set di dati in base a:
- Utilizzo della console Google Cloud
- Utilizzo del comando
bq ls
nello strumento a riga di comando bq - Chiamata a
tables.list
Metodo API - Utilizzo delle librerie client
Prima di iniziare
Concede ruoli IAM (Identity and Access Management) che concedono agli utenti le autorizzazioni necessarie per eseguire ciascuna attività in questo documento.
Visualizzazioni elenco
Le visualizzazioni elenco sono identiche alla procedura per elencare le tabelle.
Autorizzazioni obbligatorie
Per elencare le visualizzazioni in un set di dati, è necessario bigquery.tables.list
Autorizzazione IAM.
Ciascuno dei seguenti ruoli IAM predefiniti include 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 su ruoli e autorizzazioni IAM in per BigQuery, consulta Ruoli e autorizzazioni predefiniti.
Visualizzazioni elenco in un set di dati
Per elencare le viste 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. Tabelle e sono identificate da icone diverse.
SQL
Utilizza la
INFORMATION_SCHEMA.VIEWS
vista:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor 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 le query, vedi Eseguire una query interattiva.
bq
Esegui il comando bq ls
. Il flag --format
può essere utilizzato per controllare
come output. Se stai elencando le viste 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 seguente comando per elencare le visualizzazioni nel set di dati mydataset
nel tuo
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 la funzione tables.list
.
Vai
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Go BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Python BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Puoi ottenere i metadati delle visualizzazioni in base a:
- Utilizzo della console Google Cloud
- Utilizzo del comando
bq show
dello strumento a riga di comando bq - Chiamata al metodo API
tables.get
- Utilizzo delle librerie client
- Esecuzione di query sulle viste
INFORMATION_SCHEMA
Scopri di più sulle viste
La procedura per ottenere informazioni sulle viste è identica informazioni sulle tabelle.
Autorizzazioni obbligatorie
Per ottenere informazioni su una vista, devi disporre dell'autorizzazione IAM bigquery.tables.get
.
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per ottenere informazioni su una vista:
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 viste nei set di dati che crei.
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Per ottenere informazioni sulle viste:
Console
Espandi il set di dati.
Fai clic sul nome della visualizzazione.
Fai clic su Dettagli. La scheda Dettagli mostra gli elementi della vista descrizione, informazioni sulla vista e la query SQL che definisce la vista.
SQL
Esegui una query sul
INFORMATION_SCHEMA.VIEWS
visualizzazione.
L'esempio seguente recupera tutte le colonne tranne check_option
,
che viene riservato per uso futuro. I metadati restituiti si riferiscono a tutte le visualizzazioni in
DATASET_ID nel tuo progetto predefinito:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor 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 le query, vedi Eseguire una query interattiva.
bq
Esegui il comando bq show
. Il flag --format
può essere utilizzato per controllare
come output. Se ricevi informazioni su una vista in un progetto diverso da
progetto 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 vista.
Esempi:
Inserisci il comando seguente per visualizzare le informazioni su myview
in
mydataset
nel progetto predefinito.
bq show --format=prettyjson mydataset.myview
Inserisci il comando seguente per visualizzare le informazioni su myview
in
set di dati mydataset
in myotherproject
.
bq show --format=prettyjson myotherproject:mydataset.myview
API
Chiama il tables.get
e fornire i parametri pertinenti.
Vai
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Go BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Java
Prima di provare questo esempio, segui le istruzioni per la configurazione di Java nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Java BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Node.js BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Python BigQuery documentazione di riferimento.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.
Visualizza sicurezza
Per controllare l'accesso alle viste in BigQuery, consulta Visualizzazioni autorizzate.
Passaggi successivi
- Per informazioni sulla creazione delle viste, consulta la sezione Creazione delle viste.
- Per informazioni sulla creazione di una vista autorizzata, consulta Creazione di viste autorizzate.
- Per ulteriori informazioni sulla gestione delle visualizzazioni, consulta la sezione Gestione delle visualizzazioni.
- Per una panoramica di
INFORMATION_SCHEMA
, vai a Introduzione a BigQueryINFORMATION_SCHEMA
.