Aggiornamento etichette
Questa pagina spiega come aggiornare le etichette nelle risorse 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. Le eventuali autorizzazioni necessarie per eseguire un'attività sono elencate nella sezione "Autorizzazioni obbligatorie" dell'attività.
Aggiornamento delle etichette del set di dati in corso...
L'etichetta di un set di dati può essere aggiornata:
- Utilizzo della console Google Cloud
- Utilizzo delle istruzioni DDL SQL
- Utilizzo del comando
bq update
dello strumento a riga di comando bq - Chiamata a
datasets.patch
Metodo API - Utilizzo delle librerie client
Autorizzazioni obbligatorie
Per aggiornare l'etichetta di un set di dati, devi disporre dell'autorizzazione IAM bigquery.datasets.update
.
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per aggiornare l'etichetta di un set di dati:
roles/bigquery.dataOwner
roles/bigquery.admin
Inoltre, se disponi dell'autorizzazione bigquery.datasets.create
, puoi aggiornare le etichette dei set di dati che crei.
Per saperne di più su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Aggiornamento dell'etichetta di un set di dati
Per aggiornare le etichette su un set di dati, seleziona una delle seguenti opzioni:
Console
Nella console Google Cloud, seleziona il set di dati.
Nella pagina dei dettagli del set di dati, fai clic sull'icona a forma di matita a destra del Etichette.
Nella finestra di dialogo Modifica etichette:
- Per applicare altre etichette, fai clic su Aggiungi etichetta. Ogni chiave può essere usata una sola volta per set di dati, ma puoi usare la stessa chiave in all'interno dello stesso progetto.
- Modifica le chiavi o i valori esistenti per aggiornare un'etichetta.
- Fai clic su Update (Aggiorna) per salvare le modifiche.
SQL
Utilizza la
ALTER SCHEMA SET OPTIONS
Istruzione DDL
per impostare le etichette su un set di dati esistente. Le etichette delle impostazioni sovrascriveranno qualsiasi
le etichette esistenti sul set di dati. L'esempio seguente imposta una singola etichetta
il set di dati mydataset
:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
ALTER SCHEMA mydataset SET OPTIONS (labels = [('sensitivity', 'high')]);
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, consulta Eseguire una query interattiva.
bq
Per aggiungere altre etichette o per aggiornare l'etichetta di un set di dati, invia bq update
con il flag set_label
. Ripeti il flag per aggiungere o aggiornare più elementi
etichette.
Se il set di dati si trova in un progetto diverso da quello predefinito, aggiungi
al set di dati nel seguente formato: [PROJECT_ID]:[DATASET]
.
bq update \ --set_label key:value \ project_id:dataset
Dove:
- key:value corrisponde a una coppia chiave-valore per un'etichetta che vuoi aggiungere o aggiornare. Se specifichi la stessa chiave di un modello viene aggiornato il valore dell'etichetta esistente. La chiave deve essere univoca.
- project_id è l'ID progetto.
- dataset è il set di dati che stai aggiornando.
Esempio:
Per aggiornare l'etichetta department
su mydataset
, inserisci bq update
e specifica department
come chiave di etichetta. Ad esempio, per aggiornare
l'etichetta department:shipping
in department:logistics
, inserisci
. mydataset
si trova in myotherproject
, non è il tuo indirizzo predefinito
progetto.
bq update \
--set_label department:logistics \
myotherproject:mydataset
L'output è simile al seguente.
Dataset 'myotherproject:mydataset' successfully updated.
API
Per aggiungere altre etichette o aggiornare un'etichetta per un set di dati esistente, chiama
datasets.patch
e aggiungere o aggiornare la proprietà labels
per
risorsa del set di dati.
Poiché il metodo datasets.update
sostituisce l'intera risorsa del set di dati,
è preferibile il metodo datasets.patch
.
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
Questo esempio utilizza la libreria client HTTP di Google per Java per inviare una richiesta all'API BigQuery.
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.
Aggiornamento delle etichette della tabella e della visualizzazione in corso...
È possibile aggiornare un'etichetta dopo aver creato una tabella o una visualizzazione tramite:
- Utilizzo della console Google Cloud
- Utilizzo del comando
bq update
dello strumento a riga di comando bq - Chiamata a
tables.patch
Metodo API- Poiché le visualizzazioni vengono trattate come risorse di una tabella, utilizzi l'
tables.patch
per modificare sia le viste che le tabelle.
- Poiché le visualizzazioni vengono trattate come risorse di una tabella, utilizzi l'
- Utilizzo delle librerie client
Autorizzazioni obbligatorie
Per aggiornare un'etichetta di tabella o vista, devi disporre dell'autorizzazione IAM bigquery.tables.update
.
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per aggiornare una tabella o visualizzare un'etichetta:
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.admin
Inoltre, se disponi dell'autorizzazione bigquery.datasets.create
, puoi aggiornare le etichette delle tabelle e delle visualizzazioni nei set di dati che crei.
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Aggiornamento di un'etichetta di tabella o visualizzazione
Per aggiornare un'etichetta di tabella o visualizzazione:
Console
Nella console Google Cloud, seleziona la tabella o la visualizzazione.
Fai clic sulla scheda Dettagli e poi sull'icona a forma di matita a destra del Etichette.
Nella finestra di dialogo Modifica etichette:
- Per applicare altre etichette, fai clic su Aggiungi etichetta. Ogni chiave può essere usata solo una volta per tabella o visualizzazione, ma puoi utilizzare la stessa chiave nelle tabelle in set di dati diversi.
- Modifica le chiavi o i valori esistenti per aggiornare un'etichetta.
- Fai clic su Update (Aggiorna) per salvare le modifiche.
SQL
Utilizza la
ALTER TABLE SET OPTIONS
Istruzione DDL
per impostare le etichette su una tabella esistente, oppure
Istruzione DDL ALTER VIEW SET OPTIONS
per impostare le etichette su una vista esistente. Le etichette delle impostazioni sovrascriveranno qualsiasi
le etichette esistenti nella tabella o nella visualizzazione. L'esempio seguente imposta due etichette
nella tabella mytable
:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
ALTER TABLE mydataset.mytable SET OPTIONS ( labels = [('department', 'shipping'), ('cost_center', 'logistics')]);
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
bq
Per aggiungere altre etichette o per aggiornare una tabella o un'etichetta di visualizzazione, esegui il comando bq
update
con il flag set_label
. Ripeti il flag per aggiungere o aggiornare
più etichette.
Se la tabella o la visualizzazione si trova in un progetto diverso da quello predefinito, aggiungi
l'ID progetto al set di dati nel seguente formato:
project_id:dataset
.
bq update \ --set_label key:value \ project_id:dataset.table_or_view
Dove:
- key:value corrisponde a una coppia chiave-valore per un'etichetta che vuoi aggiungere o aggiornare. Se specifichi la stessa chiave di un'etichetta esistente, il valore dell'etichetta esistente viene aggiornato. La chiave deve essere univoca.
- project_id è l'ID progetto.
- dataset è il set di dati che contiene la tabella o la vista che stai aggiornamento in corso.
- table_or_view è il nome della tabella o della visualizzazione che stai aggiornando.
Esempio:
Per aggiornare l'etichetta department
per mytable
, inserisci bq update
e specifica department
come chiave di etichetta. Ad esempio, per aggiornare
l'etichetta department:shipping
in department:logistics
per mytable
,
inserisci questo comando. mytable
si trova in myotherproject
, non in tuo
progetto predefinito.
bq update \
--set_label department:logistics \
myotherproject:mydataset.mytable
L'output è simile al seguente:
Table 'myotherproject:mydataset.mytable' successfully updated.
API
Per aggiungere etichette o aggiornare un'etichetta di una tabella o una visualizzazione esistente:
chiama tables.patch
e aggiungere o aggiornare labels
per la risorsa della tabella.
Poiché le visualizzazioni vengono trattate come risorse di una tabella, utilizzi l'tables.patch
per modificare sia le viste che le tabelle.
Poiché il metodo tables.update
sostituisce l'intera risorsa del set di dati, il valore
È preferito il metodo tables.patch
.
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
Questo esempio utilizza la libreria client HTTP di Google per Java per inviare una richiesta all'API BigQuery.
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.
Aggiornamento delle etichette dei job in corso...
Al momento, l'aggiornamento dell'etichetta di un job non è supportato. Per aggiornare l'etichetta in un job, invia nuovamente il job con una nuova etichetta specificata.
Conversione delle etichette in tag
Un'etichetta con una chiave con un valore vuoto viene utilizzata come tag. Puoi creare un nuova etichetta senza valore oppure puoi trasformare un'etichetta esistente in un tag su un un set di dati, una tabella o una vista. Non puoi convertire l'etichetta di un job in un tag.
I tag possono essere utili nelle situazioni in cui stai etichettando una risorsa, ma
non è necessario il formato key:value
. Ad esempio, se hai una tabella che contiene
test dei dati utilizzati da più gruppi (supporto, sviluppo e così via),
puoi aggiungere un tag test_data
alla tabella per identificarlo.
Autorizzazioni obbligatorie
Per convertire un'etichetta in un tag, devi disporre delle seguenti autorizzazioni IAM:
bigquery.datasets.update
(consente di convertire l'etichetta di un set di dati)bigquery.tables.update
(consente di convertire una tabella o di visualizzare un'etichetta)
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per convertire un'etichetta del set di dati:
roles/bigquery.dataOwner
roles/bigquery.admin
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per convertire un'etichetta di tabella o visualizzazione:
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.admin
Inoltre, se disponi dell'autorizzazione bigquery.datasets.create
, puoi aggiornare le etichette dei set di dati che crei, nonché delle tabelle e delle visualizzazioni al loro interno.
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Conversione di un'etichetta in tag
Per convertire un'etichetta in un tag:
Console
Nella console Google Cloud, seleziona il set di dati, la tabella o la visualizzazione.
Per i set di dati, viene aperta automaticamente la pagina dei dettagli del set di dati. Per tabelle e visualizzazioni, fai clic su Dettagli per aprire la pagina dei dettagli.
Nella pagina dei dettagli, fai clic sull'icona a forma di matita a destra di Etichette.
Nella finestra di dialogo Modifica etichette:
- Elimina il valore di un'etichetta esistente.
- Fai clic su Aggiorna.
bq
Per convertire un'etichetta in tag, utilizza il comando bq update
con il metodo
Flag set_label
. Specifica la chiave, seguita da due punti, ma lascia il valore
non specificato. Questa operazione aggiorna un'etichetta esistente in un tag.
bq update \ --set_label key: \ resource_id
Dove:
- key: è la chiave di etichetta da aggiornare in un tag.
- resource_id è il nome di un set di dati, una tabella o una vista valido. Se
la risorsa si trova in un progetto diverso da quello predefinito, aggiungi l'ID progetto
nel seguente formato:
project_id:dataset
.
Esempi:
Inserisci il seguente comando per modificare l'elemento test_data:development
esistente
su mydataset
a un tag. mydataset
si trova in myotherproject
, non in tuo
progetto predefinito.
bq update --set_label test_data: myotherproject:mydataset
L'output è simile al seguente:
Dataset 'myotherproject:mydataset' successfully updated.
API
Per trasformare un'etichetta esistente in un tag, chiama la funzione datasets.patch
o tables.patch
e sostituisci i valori dell'etichetta con la stringa vuota (""
) nel
risorsa set di dati
o la risorsa tabella.
Poiché le visualizzazioni vengono trattate come risorse di una tabella, utilizzi l'tables.patch
per modificare sia le viste che le tabelle. Inoltre, poiché tables.update
sostituisce l'intera risorsa del set di dati, il metodo tables.patch
è
preferito.
Passaggi successivi
- Scopri come aggiungere etichette a BigQuery Google Cloud.
- Scopri come visualizzare le etichette su BigQuery Google Cloud.
- Scopri come filtrare le risorse utilizzando le etichette.
- Scopri come eliminare le etichette su di risorse BigQuery.
- Leggi ulteriori informazioni sull'utilizzo delle etichette nel documentazione di Resource Manager.