Aggiornamento delle etichette
Questa pagina spiega come aggiornare le etichette nelle risorse BigQuery.
Prima di iniziare
Concedi i ruoli IAM (Identity and Access Management) che concedono agli utenti le autorizzazioni necessarie per eseguire ogni attività nel documento. Le eventuali autorizzazioni necessarie per eseguire un'attività sono elencate nella sezione "Autorizzazioni richieste" dell'attività.
Aggiornamento delle etichette del set di dati
L'etichetta di un set di dati può essere aggiornata:
- Utilizzo della console Google Cloud
- Utilizzo di istruzioni DDL SQL
- Utilizzo del comando
bq update
dello strumento a riga di comando bq - Chiamare il metodo API
datasets.patch
- 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 ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, consulta Autorizzazioni e ruoli predefiniti.
Aggiornamento di un'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 di Etichette.
Nella finestra di dialogo Modifica etichette:
- Per applicare altre etichette, fai clic su Aggiungi etichetta. Ogni chiave può essere utilizzata una sola volta per set di dati, ma puoi utilizzare la stessa chiave in diversi set di dati nello stesso progetto.
- Modifica le chiavi o i valori esistenti per aggiornare un'etichetta.
- Fai clic su Update (Aggiorna) per salvare le modifiche.
SQL
Utilizza l'istruzione DDL ALTER SCHEMA SET OPTIONS
per impostare le etichette su un set di dati esistente. L'impostazione delle etichette sovrascrive qualsiasi etichetta esistente nel set di dati. L'esempio seguente imposta una singola etichetta sul 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 aggiornare l'etichetta di un set di dati, invia il comando bq update
con il flag set_label
. Ripeti il flag per aggiungere o aggiornare
più etichette.
Se il set di dati si trova in un progetto diverso da quello predefinito, aggiungi l'ID 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'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 stai aggiornando.
Esempio:
Per aggiornare l'etichetta department
su mydataset
, inserisci il comando bq update
e specifica department
come chiave di etichetta. Ad esempio, per aggiornare l'etichetta department:shipping
in department:logistics
, inserisci il comando seguente. mydataset
si trova in myotherproject
, non è il tuo progetto
predefinito.
bq update \
--set_label department:logistics \
myotherproject:mydataset
L'output sarà simile al seguente.
Dataset 'myotherproject:mydataset' successfully updated.
API
Per aggiungere altre etichette o aggiornare un'etichetta per un set di dati esistente, chiama il metodo datasets.patch
e aggiorna la proprietà labels
per la risorsa del set di dati.
Poiché il metodo datasets.update
sostituisce l'intera risorsa del set di dati, è preferibile il metodo datasets.patch
.
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Go.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare 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 di configurazione di Java disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Java.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Node.js.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Python.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Aggiornamento delle etichette di tabella e visualizzazione
Un'etichetta può essere aggiornata dopo la creazione di una tabella o di una visualizzazione da:
- Utilizzo della console Google Cloud
- Utilizzo del comando
bq update
dello strumento a riga di comando bq - Chiamata al metodo API
tables.patch
- Poiché le viste vengono trattate come risorse di una tabella, puoi utilizzare il metodo
tables.patch
per modificare sia le viste che le tabelle.
- Poiché le viste vengono trattate come risorse di una tabella, puoi utilizzare il metodo
- Utilizzo delle librerie client
Autorizzazioni obbligatorie
Per aggiornare una tabella o un'etichetta di visualizzazione, devi disporre dell'autorizzazione IAM bigquery.tables.update
.
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per aggiornare una tabella o un'etichetta di visualizzazione:
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, consulta 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 di Etichette.
Nella finestra di dialogo Modifica etichette:
- Per applicare altre etichette, fai clic su Aggiungi etichetta. Ogni chiave può essere utilizzata una sola volta per tabella o visualizzazione, ma puoi utilizzare la stessa chiave nelle tabelle o nelle viste di 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 l'istruzione DDL ALTER TABLE SET OPTIONS
per impostare le etichette in una tabella esistente o l'istruzione DDL ALTER VIEW SET OPTIONS
per impostarle in una vista esistente. L'impostazione delle etichette sovrascrive qualsiasi etichetta esistente 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, consulta Eseguire una query interattiva.
bq
Per aggiungere altre etichette o per aggiornare un'etichetta di tabella o 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 contenente la tabella o la visualizzazione che stai aggiornando.
- table_or_view è il nome della tabella o della visualizzazione che stai aggiornando.
Esempio:
Per aggiornare l'etichetta department
per mytable
, inserisci il comando bq update
e specifica department
come chiave di etichetta. Ad esempio, per aggiornare
l'etichetta department:shipping
in department:logistics
per mytable
,
inserisci il seguente comando. mytable
si trova in myotherproject
, non nel tuo progetto predefinito.
bq update \
--set_label department:logistics \
myotherproject:mydataset.mytable
L'output sarà simile al seguente:
Table 'myotherproject:mydataset.mytable' successfully updated.
API
Per aggiungere etichette o aggiornare un'etichetta per una tabella o una vista esistente,
chiama il metodo tables.patch
e aggiungi o aggiorna la proprietà labels
per la risorsa di tabella.
Poiché le viste vengono trattate come risorse di una tabella, puoi utilizzare il metodo tables.patch
per modificare sia le viste che le tabelle.
Poiché il metodo tables.update
sostituisce l'intera risorsa del set di dati, è preferibile il metodo tables.patch
.
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Go.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare 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 di configurazione di Java disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Java.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Node.js.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per le librerie client.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python disponibili nella guida rapida di BigQuery sull'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Python.
Per eseguire l'autenticazione in BigQuery, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare 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 una nuova etichetta senza valore oppure trasformare un'etichetta esistente in un tag in un set di dati, una tabella o una vista. Non puoi convertire un'etichetta di job in un tag.
I tag possono essere utili nelle situazioni in cui stai etichettando una risorsa, ma non hai bisogno del formato key:value
. Ad esempio, se hai una tabella contenente dati di test utilizzati da più gruppi (assistenza, 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 visualizzare un'etichetta)
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per convertire l'etichetta di un set di dati:
roles/bigquery.dataOwner
roles/bigquery.admin
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per convertire una tabella o un'etichetta di 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é le tabelle e le visualizzazioni al loro interno.
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, consulta Autorizzazioni e ruoli predefiniti.
Conversione di un'etichetta in un tag
Per convertire un'etichetta in un tag:
Console
Nella console Google Cloud, seleziona il set di dati, la tabella o la vista.
Per i set di dati, la pagina dei dettagli del set di dati viene aperta automaticamente. Per le tabelle e le 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 Update (Aggiorna).
bq
Per convertire un'etichetta in un tag, utilizza il comando bq update
con il flag set_label
. Specifica la chiave, seguita da due punti, ma non specificare il valore. In questo modo, un'etichetta esistente viene aggiornata a un tag.
bq update \ --set_label key: \ resource_id
Dove:
- key: è la chiave di etichetta che vuoi aggiornare in un tag.
- resource_id è il nome di un set di dati, di una tabella o di 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'etichetta test_data:development
esistente su mydataset
in un tag. mydataset
si trova in myotherproject
, non nel tuo progetto predefinito.
bq update --set_label test_data: myotherproject:mydataset
L'output sarà simile al seguente:
Dataset 'myotherproject:mydataset' successfully updated.
API
Per trasformare un'etichetta esistente in un tag, chiama il metodo datasets.patch
o il metodo tables.patch
e sostituisci i valori dell'etichetta con la stringa vuota (""
) nella risorsa del set di dati o nella risorsa di tabella.
Poiché le viste vengono trattate come risorse di una tabella, puoi utilizzare il metodo tables.patch
per modificare sia le viste che le tabelle. Inoltre, poiché il metodo tables.update
sostituisce l'intera risorsa del set di dati, è preferibile il metodo tables.patch
.
Passaggi successivi
- Scopri come aggiungere etichette alle risorse BigQuery.
- Scopri come visualizzare le etichette nelle risorse BigQuery.
- Scopri come filtrare le risorse utilizzando le etichette.
- Scopri come eliminare le etichette sulle risorse BigQuery.
- Scopri di più sull'utilizzo delle etichette nella documentazione di Resource Manager.