Elenco dei set di dati
Questo documento descrive come elencare e ottenere informazioni sui set di dati in BigQuery.
Prima di iniziare
Concedi ruoli IAM (Identity and Access Management) che forniscono agli utenti le autorizzazioni necessarie per eseguire ogni attività descritta in questo documento.
Ruolo richiesto
Per ottenere l'autorizzazione
necessaria per elencare i set di dati o ottenere informazioni su di essi,
chiedi all'amministratore di concederti il
ruolo IAM Visualizzatore metadati BigQuery (roles/bigquery.metadataViewer
)
nel tuo progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene l'autorizzazione
bigquery.datasets.get
necessaria per
elencare i set di dati o ottenere informazioni su di essi.
Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.
Quando applichi il ruolo roles/bigquery.metadataViewer
a livello di progetto o organizzazione, puoi elencare tutti i set di dati nel progetto. Quando applichi il ruolo roles/bigquery.metadataViewer
a livello di set di dati, puoi elencare tutti i set di dati per i quali ti è stato concesso questo ruolo.
Elenca set di dati
Seleziona una delle seguenti opzioni:
Console
Nel menu di navigazione, fai clic su Studio.
Nel riquadro Explorer, espandi il nome di un progetto per visualizzare i set di dati in quel progetto oppure utilizza la casella di ricerca per cercare in base al nome del set di dati.
SQL
Esegui una query sulla vista INFORMATION_SCHEMA.SCHEMATA
:
Nella console Google Cloud , vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
SELECT schema_name FROM PROJECT_ID.`region-REGION`.INFORMATION_SCHEMA.SCHEMATA;
Sostituisci quanto segue:
PROJECT_ID
: l'ID del tuo Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.REGION
: qualsiasi nome della regione del set di dati. Ad esempio:us
.
Fai clic su
Esegui.
Per maggiori informazioni su come eseguire le query, consulta Eseguire una query interattiva.
bq
Esegui il comando bq ls
per elencare i set di dati in base all'ID. Il flag --format
può essere utilizzato per controllare l'output. Se stai elencando il set di dati in un progetto diverso da quello predefinito, aggiungi il flag --project_id
al comando.
Per elencare tutti i set di dati in un progetto, inclusi i set di dati nascosti, utilizza il flag --all
o la scorciatoia -a
.
Per elencare tutti i set di dati in un progetto, esclusi quelli nascosti, utilizza il flag --datasets
o la scorciatoia -d
. Questo flag è facoltativo. Per impostazione predefinita,
i set di dati nascosti non sono elencati.
Altri flag includono:
--filter
: Elenca i set di dati che corrispondono all'espressione di filtro. Utilizza un elenco di chiavi e valori delle etichette separati da spazi nel formatolabels.key:value
. Per saperne di più sul filtraggio dei set di dati utilizzando le etichette, vedi Aggiungere e utilizzare le etichette.--max_results
o-n
: un numero intero che indica il numero massimo di risultati. Il valore predefinito è50
.
bq ls --filter labels.key:value \ --max_results integer \ --format=prettyjson \ --project_id project_id
Sostituisci quanto segue:
- key:value: una chiave e un valore dell'etichetta
- integer: un numero intero che rappresenta il numero di set di dati da elencare
- project_id: il nome del progetto
Esempi:
Inserisci il comando seguente per elencare i set di dati nel progetto predefinito. --
format
è impostato su pretty per restituire una tabella con formattazione di base.
bq ls --format=pretty
Inserisci il seguente comando per elencare i set di dati in myotherproject
. --format
è impostato su prettyjson
per restituire risultati dettagliati in formato JSON.
bq ls --format=prettyjson --project_id myotherproject
Inserisci il comando seguente per elencare tutti i set di dati, inclusi quelli nascosti, nel progetto predefinito. Nell'output, i set di dati nascosti iniziano con un trattino basso.
bq ls -a
Inserisci il comando seguente per restituire più di 50 set di dati, l'output predefinito, dal tuo progetto predefinito.
bq ls --max_results 60
Inserisci il comando seguente per elencare i set di dati nel progetto predefinito con
l'etichetta org:dev
.
bq ls --filter labels.org:dev
API
Per elencare i set di dati utilizzando l'API, chiama il metodo API datasets.list
.
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.
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.
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.
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.
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.
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.
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.
Recuperare informazioni sui set di dati
Seleziona una delle seguenti opzioni:
Console
Nel riquadro Spazio di esplorazione, espandi il progetto e seleziona un set di dati.
Espandi l'opzione
Azioni e fai clic su Apri. La descrizione e i dettagli vengono visualizzati nel riquadro dei dettagli. Le tabelle di un set di dati sono elencate con il nome del set di dati nel riquadro Explorer.
Per impostazione predefinita, i set di dati nascosti sono nascosti nella console Google Cloud . Per visualizzare informazioni sui set di dati nascosti, utilizza lo strumento a riga di comando bq o l'API.
SQL
Esegui una query sulla vista INFORMATION_SCHEMA.SCHEMATA
:
Nella console Google Cloud , vai alla pagina BigQuery.
Nell'editor di query, inserisci la seguente istruzione:
SELECT * EXCEPT (schema_owner) FROM PROJECT_ID.`region-REGION`.INFORMATION_SCHEMA.SCHEMATA;
Sostituisci quanto segue:
-
PROJECT_ID
: l'ID del tuo Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito. -
REGION
: qualsiasi nome della regione del set di dati. Ad esempio:us
.
-
Fai clic su
Esegui.
Per maggiori informazioni su come eseguire le query, consulta Eseguire una query interattiva.
Puoi anche eseguire una query sulla vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS
.
SELECT * FROM PROJECT_ID.`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_OPTIONS;
bq
Esegui il comando bq show
. Il flag --format
può essere utilizzato per controllare
l'output. Se stai recuperando informazioni su un set di dati in un progetto diverso
da quello predefinito, aggiungi l'ID progetto al nome del set di dati nel
seguente formato: project_id:dataset
.
L'output mostra le informazioni del set di dati, come il controllo dell'accesso, le etichette e la posizione. Questo comando non mostra le autorizzazioni ereditate di un set di dati, ma puoi visualizzarle nella console Google Cloud .
Per mostrare informazioni su un set di dati nascosto, utilizza il comando bq ls --all
per elencare tutti i set di dati e poi utilizza il nome del set di dati nascosto nel comando bq show
.
bq show --format=prettyjson project_id:dataset
Sostituisci quanto segue:
- project_id è il nome del tuo progetto.
- dataset è il nome del set di dati.
Esempi:
Inserisci il comando seguente per visualizzare informazioni su mydataset
nel tuo
progetto predefinito.
bq show --format=prettyjson mydataset
Inserisci questo comando per visualizzare informazioni su mydataset
in
myotherproject
.
bq show --format=prettyjson myotherproject:mydataset
Inserisci il comando seguente per visualizzare le informazioni sul set di dati nascosto
_1234abcd56efgh78ijkl1234
nel tuo progetto predefinito.
bq show --format=prettyjson _1234abcd56efgh78ijkl1234
API
Chiama il metodo API datasets.get
e fornisci eventuali parametri pertinenti.
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.
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.
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.
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.
Verifica il nome del set di dati
Gli esempi riportati di seguito mostrano come verificare se esiste un set di dati:
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.
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.
Passaggi successivi
- Per saperne di più sulla creazione di set di dati, vedi Creare set di dati.
- Per ulteriori informazioni sull'assegnazione dei controlli dell'accesso ai set di dati, vedi Controllare l'accesso ai set di dati.
- Per ulteriori informazioni sulla modifica delle proprietà del set di dati, consulta Aggiornamento delle proprietà dei set di dati.
- Per saperne di più sulla creazione e la gestione delle etichette, vedi Creare e gestire le etichette.
- Per una panoramica di
INFORMATION_SCHEMA
, vai a Introduzione a BigQueryINFORMATION_SCHEMA
.