Questa pagina è stata tradotta dall'API Cloud Translation.

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.

Vai a 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, vedi 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.

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// addDatasetLabel demonstrates adding label metadata to an existing dataset.
func addDatasetLabel(projectID, datasetID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %v", err)
	}
	defer client.Close()

	ds := client.Dataset(datasetID)
	meta, err := ds.Metadata(ctx)
	if err != nil {
		return err
	}

	update := bigquery.DatasetMetadataToUpdate{}
	update.SetLabel("color", "green")
	if _, err := ds.Update(ctx, update, meta.ETag); err != nil {
		return err
	}
	return nil
}

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.

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Dataset;
import java.util.HashMap;
import java.util.Map;

// Sample to updates a label on dataset
public class LabelDataset {

  public static void runLabelDataset() {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    labelDataset(datasetName);
  }

  public static void labelDataset(String datasetName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      // This example dataset starts with existing label { color: 'green' }
      Dataset dataset = bigquery.getDataset(datasetName);
      // Add label to dataset
      Map<String, String> labels = new HashMap<>();
      labels.put("color", "green");

      dataset.toBuilder().setLabels(labels).build().update();
      System.out.println("Label added successfully");
    } catch (BigQueryException e) {
      System.out.println("Label was not added. \n" + e.toString());
    }
  }
}

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.

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function labelDataset() {
  // Updates a label on a dataset.

  /**
   * TODO(developer): Uncomment the following lines before running the sample
   */
  // const datasetId = "my_dataset";

  // Retrieve current dataset metadata.
  const dataset = bigquery.dataset(datasetId);
  const [metadata] = await dataset.getMetadata();

  // Add label to dataset metadata
  metadata.labels = {color: 'green'};
  const [apiResponse] = await dataset.setMetadata(metadata);

  console.log(`${datasetId} labels:`);
  console.log(apiResponse.labels);
}

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.


from google.cloud import bigquery

# Construct a BigQuery client object.
client = bigquery.Client()

# TODO(developer): Set dataset_id to the ID of the dataset to fetch.
# dataset_id = "your-project.your_dataset"

dataset = client.get_dataset(dataset_id)  # Make an API request.
dataset.labels = {"color": "green"}
dataset = client.update_dataset(dataset, ["labels"])  # Make an API request.

print("Labels added to {}".format(dataset_id))

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.
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.

Vai a 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, del 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

Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// addTableLabel demonstrates adding Label metadata to a BigQuery table.
func addTableLabel(projectID, datasetID, tableID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	// tableID := "mytable"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %v", err)
	}
	defer client.Close()

	tbl := client.Dataset(datasetID).Table(tableID)
	meta, err := tbl.Metadata(ctx)
	if err != nil {
		return err
	}

	update := bigquery.TableMetadataToUpdate{}
	update.SetLabel("color", "green")
	if _, err := tbl.Update(ctx, update, meta.ETag); err != nil {
		return err
	}
	return nil
}

Java

Questo esempio utilizza la libreria client HTTP di Google per Java per inviare una richiesta all'API BigQuery.

Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Table;
import com.google.cloud.bigquery.TableId;
import java.util.HashMap;
import java.util.Map;

// Sample to adds a label to an existing table
public class LabelTable {

  public static void runLabelTable() {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    String tableName = "MY_TABLE_NAME";
    labelTable(datasetName, tableName);
  }

  public static void labelTable(String datasetName, String tableName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      // This example table starts with existing label { color: 'green' }
      Table table = bigquery.getTable(TableId.of(datasetName, tableName));
      // Add label to table
      Map<String, String> labels = new HashMap<>();
      labels.put("color", "green");

      table.toBuilder().setLabels(labels).build().update();
      System.out.println("Label added successfully");
    } catch (BigQueryException e) {
      System.out.println("Label was not added. \n" + e.toString());
    }
  }
}

Node.js

Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function labelTable() {
  // Adds a label to an existing table.

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const datasetId = 'my_dataset';
  // const tableId = 'my_table';

  const dataset = bigquery.dataset(datasetId);
  const [table] = await dataset.table(tableId).get();

  // Retrieve current table metadata
  const [metadata] = await table.getMetadata();

  // Add label to table metadata
  metadata.labels = {color: 'green'};
  const [apiResponse] = await table.setMetadata(metadata);

  console.log(`${tableId} labels:`);
  console.log(apiResponse.labels);
}

Python

Per eseguire l'autenticazione su BigQuery, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client.

# from google.cloud import bigquery
# client = bigquery.Client()
# project = client.project
# dataset_ref = bigquery.DatasetReference(project, dataset_id)
# table_ref = dataset_ref.table('my_table')
# table = client.get_table(table_ref)  # API request

assert table.labels == {}
labels = {"color": "green"}
table.labels = labels

table = client.update_table(table, ["labels"])  # API request

assert table.labels == labels

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.