Elenco dei set di dati
Questo documento descrive come elencare i set di dati in BigQuery.
Puoi elencare i set di dati nei seguenti modi:
- Utilizzo di Cloud Console.
- Viene utilizzata la query SQL
INFORMATION_SCHEMA
. - Usare il comando
bq ls
nello strumento a riga di comandobq
. - Chiamata al metodo API
datasets.list
. - Utilizzo delle librerie client.
Prima di iniziare
Concedi ruoli IAM (Identity and Access Management) che consentono agli utenti le autorizzazioni necessarie per eseguire ogni attività in questo documento.
Autorizzazioni obbligatorie
Per elencare i set di dati, devi disporre dell'autorizzazione IAM bigquery.datasets.get
.
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per creare una vista:
roles/bigquery.user
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
Inoltre, roles/bigquery.metadataViewer
e roles/bigquery.dataViewer
, se applicati a livello di progetto o di organizzazione, possono elencare tutti i set di dati presenti nel progetto.
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, consulta la sezione Ruoli e autorizzazioni predefiniti.
Elenco di set di dati in un progetto
Per elencare i set di dati in un progetto:
Console
Nel menu di navigazione, fai clic su Area di lavoro SQL.
Nel riquadro Explorer, espandi il nome di un progetto per visualizzarne i set di dati. In alternativa, utilizza la casella di ricerca per effettuare una ricerca in base al nome del set di dati.
SQL
Utilizza un qualificatore di progetto nella query INFORMATION_SCHEMA
per elencare tutti i set di dati in un progetto.
L'esempio seguente elenca tutti i set di dati disponibili nel progetto specificato:
SELECT
schema_name
FROM
'PROJECT_ID'.INFORMATION_SCHEMA.SCHEMATA
Sostituisci PROJECT_ID
con l'ID del progetto per cui vuoi elencare i set di dati disponibili.
Per ulteriori informazioni su INFORMATION_SCHEMA
, consulta Introduzione a BigQuery INFORMATION_SCHEMA.
bq
Esegui il comando bq ls
per elencare i set di dati in base all'ID del set di dati. Il flag --format
può essere utilizzato per controllare l'output. Se stai elencando un set di dati in un progetto diverso dal tuo progetto predefinito, aggiungi il flag --project_id
al comando.
Per elencare tutti i set di dati in un progetto, inclusi i set di dati anonimi, utilizza il flag --all
o la scorciatoia -a
.
Per elencare tutti i set di dati in un progetto, esclusi i set di dati anonimi, utilizza il flag --datasets
o la scorciatoia -d
. Il flag è facoltativo. Per impostazione predefinita, i set di dati anonimi non sono elencati.
Altri flag includono:
--filter
: elenca i set di dati che corrispondono all'espressione del filtro. Utilizza un elenco separato da spazi di chiavi e valori etichetta nel modulolabels.key:value
. Per ulteriori informazioni sul filtro dei set di dati mediante etichette, consulta la sezione 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 di etichetta.
- integer è un numero intero che rappresenta il numero di set di dati da elencare.
- project_id è il nome del tuo progetto.
Esempi:
Inserisci il comando seguente per elencare i set di dati nel progetto predefinito. --
format
è impostato in modo da 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 i set di dati anonimi, nel progetto predefinito. Nell'output, i set di dati anonimi iniziano con un trattino basso.
bq ls -a
Inserisci il comando seguente per restituire più dell'output predefinito di 50 set di dati 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 che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C# BigQuery.
Go
Prima di provare questo esempio, segui le istruzioni per la configurazione di Go nella guida rapida di BigQuery che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Go.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella Guida di BigQuery per l'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di BigQuery.
Node.js
Prima di provare questo esempio, segui le istruzioni per la configurazione di Node.js nella guida rapida di BigQuery che utilizza le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di BigQuery.
PHP
Prima di provare questo esempio, segui le istruzioni di configurazione di PHP nella guida rapida di BigQuery che utilizza le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API PHP BigQuery.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di BigQuery che utilizza le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python BigQuery.
Ruby
Prima di provare questo esempio, segui le istruzioni per la configurazione di Ruby nella guida rapida di BigQuery utilizzando le librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API BigQuery Ruby.
Sicurezza dei set di dati
Per controllare l'accesso ai set di dati in BigQuery, consulta Controllo dell'accesso ai set di dati. Per informazioni sulla crittografia dei dati, vedi Crittografia dei dati at-rest.
Passaggi successivi
- Per ulteriori informazioni sulla creazione di set di dati, consulta Creazione di set di dati.
- Per saperne di più sui metadati dei set di dati, consulta la sezione Informazioni sui set di dati.
- Per ulteriori informazioni sulla modifica delle proprietà del set di dati, consulta Aggiornamento dei set di dati.
- Per saperne di più sulla creazione e la gestione delle etichette, consulta Creazione e gestione delle etichette.