Filtrare le risorse tramite le etichette
Per filtrare le risorse utilizzando le etichette, puoi eseguire una delle seguenti operazioni:
- Utilizza la barra di ricerca nella console Google Cloud.
- Crea una specifica del filtro da utilizzare nell'API, nello strumento a riga di comando bq o nel client librerie.
Limitazioni
- L'API, lo strumento a riga di comando bq e le librerie client supportano l'applicazione di filtri solo per i set di dati.
- Non puoi filtrare i job per etichetta in nessuno degli strumenti 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.
Autorizzazioni obbligatorie
Per filtrare le risorse utilizzando le etichette, devi poter recuperare la risorsa metadati. Per filtrare le risorse utilizzando le etichette, devi disporre delle seguenti autorizzazioni IAM:
bigquery.datasets.get
(consente di filtrare i set di dati)bigquery.tables.get
(consente di filtrare tabelle e visualizzazioni)
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per filtrare i set di dati:
roles/bigquery.user
roles/bigquery.metadataViewer
roles/bigquery.dataViewer
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per filtrare tabelle e viste:
roles/bigquery.metadataViewer
roles/bigquery.dataViewer
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
Inoltre, se disponi dell'autorizzazione bigquery.datasets.create
, puoi filtrare le risorse che crei.
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Applicazione di filtri alle risorse nella console Google Cloud
Per generare un elenco filtrato di risorse, utilizza la console Google Cloud:
Nella console Google Cloud, vai al riquadro Explorer.
Nella barra di ricerca, inserisci la coppia
key
okey:value
. Il tuo includono corrispondenze parziali.Ad esempio, per mostrare solo i set di dati con l'etichetta
department:shipping
, puoi inseriredepartment
odepartment:shipping
.
Applicazione di filtri ai set di dati nell'API o nello strumento a riga di comando bq
Attualmente, l'API, lo strumento a riga di comando bq e le librerie client supportano l'applicazione di filtri solo per e set di dati.
Per filtrare i set di dati utilizzando l'API, lo strumento bq o le librerie client, crea una specifica del filtro e utilizzala:
- Come parametro per il flag
--filter
nello strumento bq - Come valore della proprietà
filter
nel metododatasets.list
dell'API
Limitazioni delle specifiche del filtro
Le specifiche dei filtri presentano le seguenti limitazioni:
- È supportato solo l'operatore logico
AND
. I confronti separati da spazi vengono trattati come se avessero operatoriAND
impliciti. - L'unico campo attualmente idoneo per il filtro è
labels.key
, dovekey
è il nome di un'etichetta. - Il filtro può includere fino a dieci espressioni.
- L'applicazione dei filtri è sensibile alle maiuscole.
- Al momento, l'API, lo strumento a riga di comando bq e le librerie client supportano il filtro solo per i set di dati.
Esempi di filtri di specifica
Le specifiche di un filtro utilizzano la seguente sintassi:
"field[:value][ field[:value]]..."
Sostituisci quanto segue:
field
è espresso comelabels.key
dove key è una chiave di etichetta.value
è un valore facoltativo dell'etichetta.
Gli esempi riportati di seguito mostrano come generare espressioni di filtro.
Per elencare le risorse con un'etichetta department:shipping
, usa quanto segue
specifiche del filtro:
labels.department:shipping
Per elencare le risorse utilizzando più etichette, separa le coppie key:value
con una
spazio. Lo spazio viene trattato come un operatore logico AND
. Ad esempio, per elencare
set di dati con le etichette department:shipping
e location:usa
,
utilizza la seguente specifica di filtro:
labels.department:shipping labels.location:usa
Puoi filtrare in base alla presenza di una sola chiave anziché alla corrispondenza con una coppia chiave:valore. La seguente specifica di filtro elenca tutti i set di dati
con l'etichetta department
a prescindere dal valore.
labels.department
Una specifica di filtro equivalente utilizza un asterisco per rappresentare tutti i possibili
associati alla chiave department
.
labels.department:*
Puoi anche utilizzare i tag in una specifica di filtro. Ad esempio, per elencare le risorse
con l'etichetta department:shipping
e il tag test_data
, usa quanto segue
specifiche del filtro:
labels.department:shipping labels.test_data
Filtrare i set di dati nello strumento a riga di comando bq e nell'API
Per filtrare i set di dati utilizzando l'API, lo strumento a riga di comando bq o le librerie client:
bq
Esegui il comando bq ls
con il flag --filter
. Se stai elencando
in un progetto diverso da quello predefinito, specifica
--project_id
flag.
bq ls \ --filter "filter_specification" \ --project_id project_id
Sostituisci quanto segue:
filter_specification
è una specifica di filtro valida.project_id
è l'ID progetto.
Esempi:
Inserisci il comando seguente per elencare i set di dati nel progetto predefinito che
hanno un'etichetta department:shipping
:
bq ls --filter "labels.department:shipping"
Inserisci il comando seguente per elencare i set di dati nel progetto predefinito che hanno un'etichetta department:shipping
e un tag test_data
.
bq ls --filter "labels.department:shipping labels.test_data"
Inserisci il seguente comando per elencare i set di dati in myotherproject
che hanno un'etichetta department:shipping
:
bq ls --filter "labels.department:shipping" --project_id myotherproject
L'output di ciascuno di questi comandi restituisce un elenco di set di dati come seguire.
+-----------+ | datasetId | +-----------+ | mydataset | | mydataset2| +-----------+
API
Chiama il datasets.list
API e fornire la specifica del filtro utilizzando la proprietà filter
.
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 saperne di più, consulta Configurare 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 saperne di più, consulta Configurare 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 la documentazione di riferimento dell'API BigQuery Python.
Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.
Passaggi successivi
- Scopri come aggiungere etichette a BigQuery Google Cloud.
- Scopri come visualizzare le etichette nelle risorse BigQuery.
- Scopri come aggiornare le etichette su di risorse BigQuery.
- Scopri come eliminare le etichette su di risorse BigQuery.
- Scopri di più sull'utilizzo delle etichette nella documentazione di Resource Manager.