Eliminazione delle etichette
Per eliminare un'etichetta da un set di dati, una tabella o una visualizzazione:
- 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
otables.patch
metodi API - Utilizzo delle librerie client
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à.
Eliminazione dell'etichetta di un set di dati
Le sezioni seguenti specificano le autorizzazioni e i passaggi per eliminare l'etichetta di un set di dati.
Autorizzazioni obbligatorie
Per eliminare l'etichetta di un set di dati, devi disporre delle seguenti autorizzazioni IAM:
bigquery.datasets.get
bigquery.datasets.update
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per eliminare l'etichetta di un set di dati:
roles/bigquery.dataOwner
roles/bigquery.admin
Inoltre, se disponi dell'autorizzazione bigquery.datasets.create
, puoi eliminare le etichette dei set di dati che crei.
Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.
Eliminazione dell'etichetta di un set di dati
Per eliminare un'etichetta da un set di dati, scegli 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 ogni etichetta da eliminare, fai clic su Elimina (X).
- Per salvare le modifiche, fai clic su Aggiorna.
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 elimina tutte le etichette in
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 = []);
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
bq
Per eliminare l'etichetta di un set di dati, esegui il comando bq update
Flag clear_label
. Ripeti il flag per eliminare più 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 \ --clear_label key \ project_id:dataset
Dove:
- key è la chiave di un'etichetta da eliminare.
- project_id è l'ID progetto.
- dataset è il set di dati che stai aggiornando.
Esempi:
Per eliminare l'etichetta department:shipping
da mydataset
, inserisci il
bq update
con il flag --clear_label
. mydataset
è in
progetto predefinito.
bq update --clear_label department mydataset
Per eliminare l'etichetta department:shipping
da mydataset
in
myotherproject
, inserisci il comando bq update
con --clear_label
flag.
bq update --clear_label department myotherproject:mydataset
Per eliminare più etichette da un set di dati, ripeti il flag clear_label
e
specificare la chiave di ciascuna etichetta. Ad esempio, per eliminare department:shipping
e cost_center:logistics
etichette di mydataset
nell'etichetta predefinita
progetto, inserisci:
bq update \
--clear_label department \
--clear_label cost_center \
mydataset
Per ciascuno di questi esempi, l'output è simile al seguente:
Dataset 'myproject:mydataset' successfully updated.
API
Per eliminare una determinata etichetta da un set di dati esistente, richiama il metodo
datasets.patch
e aggiorna labels
per la risorsa del set di dati
impostando il valore-chiave dell'etichetta su null
.
Per eliminare tutte le etichette da un set di dati, richiama il metodo
datasets.patch
ed elimina la proprietà labels
.
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
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.
Eliminazione di un'etichetta di tabella o visualizzazione
Puoi eliminare una tabella o visualizzare un'etichetta nei seguenti modi:
- Utilizzo della console Google Cloud
- Utilizzo delle istruzioni DDL SQL
- Utilizzo del comando
bq update
dello strumento a riga di comando bq - Chiamata a
tables.patch
Metodo API- Poiché le viste sono trattate come risorse di una tabella,
tables.patch
è utilizzato per modificare sia viste sia tabelle.
- Poiché le viste sono trattate come risorse di una tabella,
- Utilizzo delle librerie client
Autorizzazioni obbligatorie
Per eliminare un'etichetta di tabella o vista, devi disporre delle seguenti autorizzazioni IAM:
bigquery.tables.get
bigquery.tables.update
Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per eliminare una tabella o visualizzare un'etichetta:
roles/bigquery.dataEditor
roles/bigquery.dataOwner
roles/bigquery.admin
Inoltre, se disponi dell'autorizzazione bigquery.datasets.create
, puoi eliminare 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.
Eliminazione di un'etichetta di tabella o visualizzazione
Per eliminare un'etichetta da una tabella o una visualizzazione, scegli una delle seguenti opzioni:
Console
Nella console Google Cloud, seleziona il set di dati.
Fai clic sulla scheda Dettagli, poi sull'icona a forma di matita per a destra di Etichette.
Nella finestra di dialogo Modifica etichette:
Per ogni etichetta da eliminare, fai clic su Elimina (X).
Per salvare le modifiche, fai clic su Aggiorna.
SQL
Utilizza la
Istruzione DDL ALTER TABLE SET OPTIONS
per impostare l'etichetta in una tabella esistente oppure l'istruzione
Istruzione DDL ALTER VIEW SET OPTIONS
per impostare l'etichetta su una vista esistente. Le etichette delle impostazioni sovrascriveranno qualsiasi
le etichette esistenti nella tabella o nella visualizzazione. L'esempio seguente elimina tutti
etichette dalla tabella mytable
:
Nella console Google Cloud, vai alla pagina BigQuery.
Nell'editor query, inserisci la seguente istruzione:
ALTER TABLE mydataset.mytable SET OPTIONS (labels = []);
Fai clic su
Esegui.
Per ulteriori informazioni su come eseguire le query, vedi Eseguire una query interattiva.
bq
Per eliminare un'etichetta da una tabella o una visualizzazione, esegui il comando bq update
con
il flag clear_label
. Ripeti il flag per eliminare 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 \ --clear_label key \ project_id:dataset.table_or_view
Dove:
- key è la chiave di un'etichetta da eliminare.
- project_id è l'ID progetto.
- dataset è il set di dati che stai aggiornando.
- table_or_view è il nome della tabella o della visualizzazione che stai aggiornando.
Esempi:
Per eliminare l'etichetta department:shipping
da mydataset.mytable
, inserisci
il comando bq update
con il flag --clear_label
. mydataset
partecipa
il progetto predefinito.
bq update --clear_label department mydataset.mytable
Per eliminare l'etichetta department:shipping
da mydataset.myview
in
myotherproject
, inserisci il comando bq update
con --clear_label
flag.
bq update --clear_label department myotherproject:mydataset.myview
Per eliminare più etichette da una tabella o una visualizzazione, ripeti clear_label
e specificare la chiave di ciascuna etichetta. Ad esempio, per eliminare
Etichetta department:shipping
e cost_center:logistics
etichetta da
mydataset.mytable
nel progetto predefinito, inserisci:
bq update \
--clear_label department \
--clear_label cost_center \
mydataset.mytable
Per ciascuno di questi esempi, l'output è simile al seguente:
Table 'myproject:mydataset.mytable' successfully updated.
API
Per eliminare una determinata etichetta da una tabella o una vista esistente, chiama il metodo
tables.patch
e aggiorna labels
per la risorsa della tabella
impostando il valore-chiave dell'etichetta su null
.
Per eliminare tutte le etichette da una tabella o una visualizzazione, chiama il metodo
tables.patch
ed elimina la proprietà labels
.
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.
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.
Eliminazione delle etichette del job in corso...
Al momento, l'eliminazione di un'etichetta da un job esistente non è supportata.
Passaggi successivi
- Scopri come aggiungere etichette a BigQuery Google Cloud.
- Scopri come visualizzare le etichette su BigQuery Google Cloud.
- Scopri come aggiornare le etichette su di risorse BigQuery.
- Scopri come filtrare le risorse utilizzando le etichette.
- Leggi ulteriori informazioni sull'utilizzo delle etichette nel documentazione di Resource Manager.