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 concedono agli utenti le autorizzazioni necessarie per eseguire ogni attività in questo documento.
Ruolo richiesto
Per ottenere l'autorizzazione necessaria per elencare i set di dati o ottenere informazioni sui set di dati,
chiedi all'amministratore di concederti
Ruolo IAM Visualizzatore metadati BigQuery (roles/bigquery.metadataViewer
) per il progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questo ruolo predefinito contiene
bigquery.datasets.get
, che è
necessarie per elencare i set di dati
o ottenere informazioni sui set di dati.
Potresti anche riuscire a ottenere questa autorizzazione con ruoli personalizzati e altri ruoli predefiniti.
Quando applichi il ruolo roles/bigquery.metadataViewer
al progetto o
a livello di organizzazione, puoi elencare tutti i set di dati nel progetto. Quando
applicare il ruolo roles/bigquery.metadataViewer
a livello del set di dati, puoi
elencare tutti i set di dati per cui ti è stato concesso
il ruolo in questione.
Elenca set di dati
Seleziona una delle seguenti opzioni:
Console
Nel menu di navigazione, fai clic su BigQuery Studio.
Nel riquadro Explorer, espandi il nome di un progetto per visualizzare i set di dati in il progetto o usa la casella di ricerca per cercare in base al nome del set di dati.
SQL
Esegui la query sulla vista INFORMATION_SCHEMA.SCHEMATA
:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor 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 progetto Google Cloud. 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 ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
bq
Esegui il comando bq ls
per elencare i set di dati in base all'ID. --format
per controllare l'output. Se stai elencando il set di dati in una
per un progetto diverso da quello predefinito, aggiungi il flag --project_id
.
Per elencare tutti i set di dati in un progetto, inclusi
set di dati nascosti,
usa il flag --all
o la scorciatoia -a
.
Per elencare tutti i set di dati in un progetto, esclusi quelli nascosti, utilizza la classe
Il flag --datasets
o la scorciatoia -d
. Questo flag è facoltativo. Per impostazione predefinita,
i set di dati nascosti non vengono elencati.
I flag aggiuntivi includono:
--filter
: elenca i set di dati che corrispondono all'espressione di filtro. Utilizza un elenco separato da spazi di chiavi e valori di etichetta nel formatolabels.key:value
. Per ulteriori informazioni filtrando i set di dati tramite etichette, vedi Aggiunta e utilizzo delle etichette.--max_results
o-n
: un numero intero che indica il numero massimo di che consentono di analizzare i dati e visualizzare i 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 di etichetta
- integer: un numero intero che rappresenta il numero di set di dati da elenco
- project_id: il nome del progetto
Esempi:
Inserisci il comando seguente per elencare i set di dati nel progetto predefinito. --
format
è impostato su abbastanza per restituire una tabella formattata di base.
bq ls --format=pretty
Inserisci il comando seguente 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 tuo progetto predefinito. Nell'output, i set di dati nascosti iniziano con un trattino basso.
bq ls -a
Inserisci il comando seguente per restituire un output superiore all'output predefinito (50) i set di dati del 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 la funzione datasets.list
API.
C#
Prima di provare questo esempio, segui le istruzioni per la configurazione di C# nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API C# 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.
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.
PHP
Prima di provare questo esempio, segui le istruzioni per la configurazione di PHP nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API PHP 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.
Ruby
Prima di provare questo esempio, segui le istruzioni per la configurazione di Ruby nel Guida rapida di BigQuery con librerie client. Per ulteriori informazioni, consulta API Ruby 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.
Ottieni 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
Azioni e fai clic su Apri. La descrizione e i dettagli 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 mostrare le informazioni su utilizzare lo strumento a riga di comando bq o l'API.
SQL
Esegui la query sulla vista INFORMATION_SCHEMA.SCHEMATA
:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor 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 progetto Google Cloud. 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 ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
Puoi anche eseguire 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
come output. Se ottieni informazioni su un set di dati in un progetto,
rispetto al progetto predefinito, aggiungi l'ID progetto al nome del set di dati nella
nel seguente formato: project_id:dataset
.
Per mostrare le informazioni su un
set di dati nascosto,
usa bq ls --all
per elencare tutti i set di dati, quindi utilizzare 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 le informazioni su mydataset
nel tuo
progetto predefinito.
bq show --format=prettyjson mydataset
Inserisci il comando seguente per visualizzare le 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 progetto predefinito.
bq show --format=prettyjson _1234abcd56efgh78ijkl1234
API
Chiama il datasets.get
API e fornire eventuali 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.
Verifica il nome del set di dati
I seguenti esempi mostrano come verificare se un set di dati esiste:
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.
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.
Passaggi successivi
- Per saperne di più sulla creazione di set di dati, consulta Creazione di set di dati.
- Per ulteriori informazioni sull'assegnazione dei controlli di accesso ai set di dati, consulta Controllo dell'accesso ai set di dati.
- Per saperne di più sulla modifica delle proprietà del set di dati, consulta Aggiornare le proprietà del set di dati.
- Per ulteriori informazioni sulla creazione e la gestione delle etichette, consulta Creazione e gestione delle etichette.
- Per una panoramica di
INFORMATION_SCHEMA
, vai a Introduzione a BigQueryINFORMATION_SCHEMA
.