Aggiunta di etichette alle risorse

Questa pagina spiega come etichettare le risorse BigQuery.

Prima di iniziare

Concedi i ruoli IAM (Identity and Access Management) che concedono agli utenti le autorizzazioni necessarie per eseguire ogni attività in questo documento. Eventuali autorizzazioni richieste per eseguire un'attività sono elencate nella sezione "Ruoli IAM richiesti" dell'attività.

Aggiunta di etichette ai set di dati

Un'etichetta può essere aggiunta a un set di dati BigQuery al momento della creazione utilizzando il comando bq mk dello strumento a riga di comando bq o chiamando il metodo API datasets.insert. Attualmente, non puoi aggiungere un'etichetta a un set di dati quando viene creato utilizzando la console Google Cloud.

Questa pagina illustra come aggiungere un'etichetta a un set di dati dopo averlo creato. Per maggiori informazioni sull'aggiunta di un'etichetta durante la creazione di un set di dati, consulta Creare un set di dati.

È possibile aggiungere un'etichetta dopo la creazione di un set di dati:

  • Utilizzo della console Google Cloud
  • Utilizzo delle istruzioni DDL SQL
  • Utilizzo del comando bq update dello strumento a riga di comando bq
  • Chiamata del metodo dell'API datasets.patch
  • Utilizzo delle librerie client

Quando aggiungi un'etichetta a un set di dati, questa non viene propagata alle risorse al suo interno. Le etichette dei set di dati non vengono ereditate da tabelle o viste. Inoltre, quando aggiungi un'etichetta a un set di dati, questa viene inclusa nei dati di fatturazione dello spazio di archiviazione, ma non nei dati di fatturazione relativi al job.

Per ulteriori dettagli sul formato di un'etichetta, consulta Requisiti per le etichette.

Ruoli IAM richiesti

Per ottenere l'autorizzazione necessaria per aggiungere un'etichetta a un set di dati esistente, chiedi all'amministratore di concederti Ruolo IAM Editor dati BigQuery (roles/bigquery.dataEditor). Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene bigquery.datasets.update autorizzazione, che è obbligatorio aggiungere un'etichetta a un set di dati esistente.

Potresti anche riuscire a ottenere questa autorizzazione con ruoli personalizzati altri ruoli predefiniti.

Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.

Aggiunta di un'etichetta a un set di dati

Per aggiungere un'etichetta a un set di dati dopo la sua creazione:

Console

  1. Nella console Google Cloud, seleziona il set di dati.

  2. Nella pagina dei dettagli del set di dati, fai clic sull'icona a forma di matita a destra di Etichette.

    Matita per etichette.

  3. Nella finestra di dialogo Modifica etichette:

    • Fai clic su Aggiungi etichetta.
    • Inserisci la chiave e il valore. 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 set di dati diversi nello stesso progetto.
    • Per aggiornare un'etichetta, modifica le chiavi o i valori esistenti.
    • 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 imposta un'etichetta sul set di dati mydataset:

  1. Nella console Google Cloud, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nell'editor di query, inserisci la seguente istruzione:

    ALTER SCHEMA mydataset
SET OPTIONS (
  labels = [('sensitivity', 'high')]);

  3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Per aggiungere un'etichetta a un set di dati esistente, esegui il comando bq update il flag set_label. Ripeti il flag per aggiungere 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 --set_label KEY:VALUE PROJECT_ID:DATASET

Sostituisci quanto segue:

  • KEY:VALUE: una coppia chiave-valore per un'etichetta che che vuoi aggiungere. La chiave deve essere univoca. Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti devono utilizzare la codifica UTF-8 e i caratteri internazionali sono consentito.
  • PROJECT_ID: il tuo ID progetto.
  • DATASET: il set di dati che stai etichettando.

Esempi:

Per aggiungere un'etichetta per monitorare i reparti, inserisci il comando bq update e specificare department come chiave di etichetta. Ad esempio, per aggiungere un'etichetta department:shipping a mydataset nel progetto predefinito, inserisci:

    bq update --set_label department:shipping mydataset

Per aggiungere più etichette a un set di dati, ripeti il flag set_label e specifica una chiave univoca per ogni etichetta.Ad esempio, per aggiungere un elemento department:shipping e cost_center:logistics etichetta su mydataset nell'impostazione predefinita progetto, inserisci:

    bq update \
    --set_label department:shipping \
    --set_label cost_center:logistics \
    mydataset

API

Per aggiungere un'etichetta a un set di dati esistente, chiama il metodo datasets.patch e compila la proprietà labels per la risorsa 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 la documentazione di riferimento dell'API BigQuery Go.

Per autenticarti a BigQuery, configura le credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare 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 di configurazione Java riportate nella guida rapida all'utilizzo di BigQuery con le librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API BigQuery Java.

Per autenticarti a BigQuery, configura le credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare 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 main(String[] args) {
    // 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 autenticarti a BigQuery, configura le credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare 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))

Aggiungere etichette a tabelle e viste

Un'etichetta può essere aggiunta a una tabella o a una visualizzazione quando viene creata tramite:

  • Utilizzo del comando bq mk dello strumento a riga di comando bq
  • Chiamata del metodo dell'API tables.insert

Questa pagina spiega come aggiungere un'etichetta a una tabella o una vista esistente. Per maggiori informazioni informazioni sull'aggiunta di un'etichetta quando crei una tabella o una vista, consulta Creazione di una tabella o Creazione di una vista.

È possibile aggiungere un'etichetta dopo aver creato una tabella o una visualizzazione mediante:

  • Utilizzo della console Google Cloud
  • Utilizzo del comando bq update dello strumento a riga di comando bq
  • Chiamata a tables.patch Metodo API
  • Utilizzo delle librerie client

Poiché le visualizzazioni sono trattate come risorse di una tabella, utilizzi l'tables.patch per modificare sia le viste che le tabelle.

Ruoli IAM richiesti

Per ottenere le autorizzazioni necessarie per aggiungere un'etichetta a una tabella o una vista esistente, chiedi all'amministratore di concederti Ruolo IAM Editor dati BigQuery (roles/bigquery.dataEditor). Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per aggiungere un'etichetta a una tabella o una vista esistente. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per aggiungere un'etichetta a una tabella o una vista esistente sono necessarie le seguenti autorizzazioni:

  • bigquery.tables.update
  • bigquery.tables.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.

Aggiunta di un'etichetta a una tabella o una vista

Per aggiungere un'etichetta a una tabella o una vista esistente:

Console

  1. Nella console Google Cloud, seleziona la tabella o la visualizzazione.

  2. Fai clic sulla scheda Dettagli.

    Dettagli della tabella.

  3. Fai clic sull'icona a forma di matita a destra di Etichette.

    Matita per etichette.

  4. Nella finestra di dialogo Modifica etichette:

    • Fai clic su Aggiungi etichetta.
    • Inserisci la chiave e il valore per aggiungere un'etichetta. 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 set di dati diversi 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 TABLE SET OPTIONS per impostare le etichette in una tabella esistente o l'istruzione DDL ALTER VIEW SET OPTIONS per impostare le etichette in 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:

  1. Nella console Google Cloud, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nell'editor di query, inserisci la seguente istruzione:

    ALTER TABLE mydataset.mytable
SET OPTIONS (
  labels = [('department', 'shipping'), ('cost_center', 'logistics')]);

  3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Per aggiungere un'etichetta a una tabella o una vista esistente, esegui il comando bq update con il flag set_label. Per aggiungere più etichette, ripeti il flag.

Se la tabella o la vista 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

Sostituisci quanto segue:

  • KEY:VALUE: una coppia chiave-valore per un'etichetta che che vuoi aggiungere. La chiave deve essere univoca. Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti devono utilizzare la codifica UTF-8 e i caratteri internazionali sono consentito.
  • PROJECT_ID: il tuo ID progetto.
  • DATASET: il set di dati che contiene la tabella o la vista che stai etichettando.
  • TABLE_OR_VIEW: il nome della tabella o della visualizzazione che stai etichettando.

Esempi:

Per aggiungere un'etichetta di tabella che monitori i reparti, inserisci il comando bq update e specificare department come chiave di etichetta. Ad esempio, per aggiungere Etichetta department:shipping a mytable nel progetto predefinito, inserisci:

    bq update --set_label department:shipping mydataset.mytable

Per aggiungere un'etichetta della visualizzazione che monitora i reparti, inserisci il comando bq update e specifica department come chiave dell'etichetta. Ad esempio, per aggiungere Etichetta department:shipping a myview nel progetto predefinito, inserisci:

    bq update --set_label department:shipping mydataset.myview

Per aggiungere più etichette a una tabella o una visualizzazione, ripeti il flag set_label e specificare una chiave univoca per ogni etichetta. Ad esempio, per aggiungere Etichetta department:shipping e cost_center:logistics etichetta in mytable nel progetto predefinito, inserisci:

    bq update \
    --set_label department:shipping \
    --set_label cost_center:logistics \
    mydataset.mytable

API

Per aggiungere un'etichetta a una tabella o una visualizzazione esistente, chiama il metodo tables.patch e compila la proprietà labels per il risorsa della tabella.

Poiché le visualizzazioni vengono trattate come risorse di tabelle, utilizza il tables.patch metodo per modificare sia le visualizzazioni sia le tabelle.

Poiché il metodo tables.update sostituisce l'intera risorsa del set di dati, è preferibile 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 autenticarti a BigQuery, configura le 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.

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 autenticarti a BigQuery, configura le credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare 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 main(String[] args) {
    // 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

Prima di provare questo esempio, segui le istruzioni di configurazione Node.js riportate nella guida rapida all'utilizzo di BigQuery con le 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 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

Prima di provare questo esempio, segui le istruzioni di configurazione Python riportate nella guida rapida all'utilizzo delle librerie client di BigQuery. Per ulteriori informazioni, consulta API Python BigQuery documentazione di riferimento.

Per autenticarti a BigQuery, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per le librerie client. 

from google.cloud import bigquery

client = bigquery.Client()

# TODO(dev): Change table_id to the full name of the table you want to create.
table_id = "your-project.your_dataset.your_table_name"

table = client.get_table(table_id)  # API request

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

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

print(f"Added {table.labels} to {table_id}.")

Aggiunta di etichette ai job

Le etichette possono essere aggiunte ai job di query tramite la riga di comando utilizzando il flag --label dello strumento a riga di comando bq. Lo strumento bq supporta l'aggiunta di etichette solo ai job di query.

Puoi anche aggiungere un'etichetta a un job quando viene inviato tramite l'API specificando la proprietà labels nella configurazione del job quando chiami il metodo jobs.insert. L'API può essere utilizzato per aggiungere etichette a qualsiasi tipo di job.

Non puoi aggiungere etichette alle etichette né aggiornarle per quelle in attesa, in esecuzione o completate di lavoro.

Quando aggiungi un'etichetta a un job, questa viene inclusa nei dati di fatturazione.

Ruoli IAM richiesti

Per ottenere l'autorizzazione necessaria per aggiungere un'etichetta a un job, chiedi all'amministratore di concederti il ruolo IAM Utente BigQuery (roles/bigquery.user). Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione bigquery.jobs.create necessaria per aggiungere un'etichetta a un job.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per ulteriori informazioni su ruoli e autorizzazioni IAM in BigQuery, vedi Autorizzazioni e ruoli predefiniti.

Aggiunta di un'etichetta a un job

Per aggiungere un'etichetta a un job:

bq

Per aggiungere un'etichetta a un job di query, esegui il comando bq query con il flag --label. Per aggiungere più etichette, ripeti l'indicatore. La Il flag --nouse_legacy_sql indica che la query è in formato GoogleSQL a riga di comando.

bq query --label KEY:VALUE --nouse_legacy_sql 'QUERY'

Sostituisci quanto segue:

  • KEY:VALUE: una coppia chiave-valore per un'etichetta che vuoi aggiungere al job di query. La chiave deve essere univoca. Chiavi e valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini bassi. Tutti i caratteri devono utilizzare la codifica UTF-8 e sono consentiti caratteri internazionali. Per aggiungere più etichette a un job di query, ripeti il flag --label e specifica una chiave univoca per ogni etichetta.
  • QUERY: una query GoogleSQL valida.

Esempi:

Per aggiungere un'etichetta a un job di query, inserisci:

    bq query \
    --label department:shipping \
    --nouse_legacy_sql \
    'SELECT
       column1, column2
     FROM
       `mydataset.mytable`'

Per aggiungere più etichette a un job di query, ripeti il flag --label e specificare una chiave univoca per ogni etichetta. Ad esempio, per aggiungere Etichetta department:shipping e cost_center:logistics etichetta a una query job, inserisci:

    bq query \
    --label department:shipping \
    --label cost_center:logistics \
    --nouse_legacy_sql \
    'SELECT
       column1, column2
     FROM
       `mydataset.mytable`'

API

Per aggiungere un'etichetta a un job, chiama il metodo jobs.insert e compila la proprietà labels per la configurazione del job. Puoi utilizzare l'API per aggiungere etichette a qualsiasi tipo di job.

Associare i job in una sessione a un'etichetta

Se esegui query in una sessione, puoi assegnare un'etichetta a tutti i job di query futuri nella sessione utilizzando le query con più istruzioni di BigQuery.

SQL

Imposta la @@query_label di sistema nella sessione eseguendo questa query:

  SET @@query_label = "KEY:VALUE";

  • KEY:VALUE: una coppia chiave-valore che l'etichetta deve assegnare a tutte le occorrenze future query nella sessione. Puoi anche aggiungere più coppie chiave-valore, separate da una virgola (ad es. SET @@query_label = "key1:value1,key2:value2"). La chiave deve essere univoca. Le chiavi e i valori possono contenere solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8 della codifica e caratteri internazionali.

Esempio:

  SET @@query_label = "cost_center:logistics";

API

Per aggiungere un'etichetta a un job di query in una sessione quando esegui una query con una chiamata API, chiama jobs.insert e compilano la proprietà query_label per il connectionProperties configurazione del job.

Dopo aver associato un'etichetta di query a una sessione ed eseguito query all'interno della sessione, puoi raccogliere i log di controllo per le query con quell'etichetta. Per ulteriori informazioni, consulta Informazioni sugli audit log per BigQuery.

Aggiunta di un'etichetta senza un valore

Un'etichetta con una chiave con un valore vuoto viene talvolta chiamata tag. Questo non deve essere confuso con una risorsa di tag. Per maggiori informazioni, consulta Etichette e tag. Puoi creare una nuova etichetta senza valore o puoi rimuovere un valore da un chiave di etichetta esistente.

Le etichette senza valori possono essere utili nelle situazioni in cui stai etichettando un ma non hai bisogno del formato chiave-valore. Ad esempio, se una tabella contiene dati di test utilizzati da più gruppi, come il supporto o sviluppo, puoi aggiungere un'etichetta test_data alla tabella per identificarla.

Per aggiungere un'etichetta senza un valore:

Console

  1. Nella console Google Cloud, seleziona la risorsa appropriata (un set di dati, una tabella o una vista).

  2. Per i set di dati, viene aperta automaticamente la pagina dei dettagli del set di dati. Per tabelle e viste, fai clic su Dettagli per aprire la pagina dei dettagli.

    Dettagli tabella.

  3. Nella pagina dei dettagli, fai clic sull'icona a forma di matita a destra di Etichette.

    Matita per etichette.

  4. Nella finestra di dialogo Modifica etichette:

    • Fai clic su Aggiungi etichetta.
    • Inserisci una nuova chiave e lascia vuoto il valore. Per applicare altre etichette, fai clic su Aggiungi etichetta e ripeti l'operazione.
    • Per salvare le modifiche, fai clic su Aggiorna.

SQL

Per aggiungere un'etichetta senza un valore, utilizza l'istruzione DDL ALTER TABLE SET OPTIONS:

  1. Nella console Google Cloud, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nell'editor di query, inserisci la seguente istruzione:

    ALTER TABLE mydataset.mytable
SET OPTIONS (
  labels=[("key1", ""), ("key2", "")]);

  3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Per aggiungere un'etichetta senza un valore a una risorsa esistente, utilizza il metodo il comando bq update con Flag set_label. Specifica la chiave, seguita da due punti, ma lascia il valore non specificato.

bq update --set_label KEY: RESOURCE_ID

Sostituisci quanto segue:

  • KEY:: la chiave di etichetta che vuoi utilizzare.
  • RESOURCE_ID: nome valido per un set di dati, una tabella o una vista. Se la risorsa si trova in un progetto diverso da quello predefinito, aggiungi la risorsa ID progetto nel seguente formato: PROJECT_ID:DATASET.

Esempi:

Inserisci questo comando per creare un'etichetta test_data per mydataset.mytable. mydataset è nel tuo progetto predefinito.

bq update --set_label test_data: mydataset

API

Chiama il metodo datasets.patch o il metodo tables.patch e aggiungi le etichette con il valore impostato sulla stringa vuota ("") nella risorsa set di dati o nella risorsa tabella. Puoi rimuovere i valori dalle etichette esistenti sostituendo i valori con la stringa vuota.

Poiché le visualizzazioni vengono trattate come risorse di tabelle, utilizza il metodo tables.patch per modificare sia le visualizzazioni sia le tabelle. Inoltre, poiché il metodo tables.update sostituisce l'intera risorsa set di dati, il metodo tables.patch è preferito.

Passaggi successivi