Agrega etiquetas a los recursos

En esta página, se explica cómo etiquetar tus recursos de BigQuery.

Agrega etiquetas de conjunto de datos

Cuando se crea una etiqueta, esta se puede agregar a un conjunto de datos de BigQuery mediante el comando bq mk de la herramienta de línea de comandos o con una llamada al método datasets.insert de la API. En la actualidad, no puedes agregar una etiqueta a un conjunto de datos cuando se crea a través de GCP Console o la IU web clásica de BigQuery.

En esta página, se explica cómo agregar una etiqueta a un conjunto de datos después de crearla. Para obtener más información sobre cómo agregar una etiqueta cuando creas un conjunto de datos, consulta Crea un conjunto de datos.

Se puede agregar una etiqueta después de la creación de un conjunto de datos de las formas siguientes:

• Con GCP Console o la IU web de BigQuery
• Con el comando bq update de la herramienta de línea de comandos
• Mediante una llamada datasets.patch al método de la API
• Con las bibliotecas cliente

Cuando agregas una etiqueta a un conjunto de datos, no se propaga a los recursos dentro de este. Las tablas ni las vistas heredan las etiquetas del conjunto de datos. Además, una etiqueta se incluye en tus datos de facturación de almacenamiento cuando la agregas a un conjunto de datos, pero no verás etiquetas de conjuntos de datos en los datos de facturación relacionados con el trabajo.

Permisos necesarios

Como mínimo, para poder agregar una etiqueta a un conjunto de datos existente, debes tener permisos de bigquery.datasets.update. Las siguientes funciones predefinidas de Cloud IAM incluyen los permisos de bigquery.datasets.update:

• bigquery.dataOwner
• bigquery.admin

Además, si un usuario tiene permisos de bigquery.datasets.create, cuando cree un conjunto de datos, se le otorgará el acceso bigquery.dataOwner. El acceso bigquery.dataOwner ofrece al usuario la capacidad de agregar etiquetas a sus conjuntos de datos.

Para obtener más información sobre las funciones de Cloud IAM y los permisos en BigQuery, consulta los permisos y funciones predefinidas.

Agrega una etiqueta a un conjunto de datos

Sigue estos pasos para agregar una etiqueta a un conjunto de datos después de crearla:

Console

1. Selecciona el conjunto de datos en GCP Console.

2. En la página de detalles del conjunto de datos, haz clic en el ícono de lápiz a la derecha de Etiquetas (Labels).

   

3. En el cuadro de diálogo Editar etiquetas (Edit labels), sigue estos pasos:

   • Haz clic en Agregar etiqueta (Add label).
   • Ingresa la clave y el valor para agregar una etiqueta. Para aplicar etiquetas adicionales, haz clic en Agregar etiqueta (Add label). Se puede usar cada clave solo una vez por conjunto de datos, pero puedes usar la misma clave en otros conjuntos de datos del mismo proyecto.
   • Modifica las claves o valores existentes para actualizar una etiqueta.
   • Haz clic en Actualizar (Update) para guardar los cambios.

IU clásica

1. Selecciona el conjunto de datos en la IU web de BigQuery.

2. En la página Detalles del conjunto de datos (Dataset Details), a la derecha de Etiquetas (Labels), haz clic en Editar (Edit).

   

3. En el cuadro de diálogo Editar etiquetas (Edit Labels), sigue estos pasos:

   • Ingresa la clave y el valor para agregar una etiqueta. Para aplicar etiquetas adicionales, haz clic en Agregar etiqueta (Add Label). Se puede usar cada clave solo una vez por conjunto de datos, pero puedes usar la misma clave en otros conjuntos de datos del mismo proyecto.
   • Modifica las claves o valores existentes para actualizar una etiqueta.

   • Haz clic en OK (Aceptar).

     

CLI

Para agregar una etiqueta a un conjunto de datos existente, ejecuta el comando bq update con la marca set_label. Repite la marca para agregar varias etiquetas.

Si el conjunto de datos se encuentra en otro proyecto que no sea el predeterminado, debes agregar el ID del proyecto al conjunto de datos con el formato siguiente: project_id:dataset.

bq update --set_label key:value project_id:dataset

En el que:

• key:value corresponde a un par clave-valor para una etiqueta que deseas agregar. La clave debe ser exclusiva.
• project_id es el ID del proyecto.
• dataset es el conjunto de datos que quieres etiquetar.

Ejemplos:

A fin de agregar una etiqueta para realizar un seguimiento de los departamentos, debes ingresar el comando bq update y especificar department como la clave de etiqueta. Por ejemplo, para agregar una etiqueta department:shipping a mydataset en tu proyecto predeterminado, ingresa el comando siguiente:

    bq update --set_label department:shipping mydataset

Para agregar múltiples etiquetas a un conjunto de datos, repite la marca set_label y especifica una clave exclusiva para cada etiqueta. Por ejemplo, para agregar las etiquetas department:shipping y cost_center:logistics a mydataset a tu proyecto predeterminado, ingresa el comando siguiente:

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

API

Si deseas agregar una etiqueta a un conjunto de datos existente, llama al método datasets.patch y propaga la propiedad labels para el recurso de conjunto de datos.

Dado que el método datasets.update reemplaza todo el recurso de conjunto de datos, es preferible usar el método datasets.patch.

Go

Antes de probar este ejemplo, sigue las instrucciones de configuración de Go incluidas en la Guía de inicio rápido de BigQuery con bibliotecas cliente. A fin de obtener más información, consulta la Documentación de referencia de la API de Go de BigQuery.

Ver en GitHub Comentarios

// To run this sample, you will need to create (or reuse) a context and
// an instance of the bigquery client.  For example:
// import "cloud.google.com/go/bigquery"
// ctx := context.Background()
// client, err := bigquery.NewClient(ctx, "your-project-id")
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
}

Java

En esta muestra, se usa la biblioteca cliente HTTP de Google para Java a fin de enviar una solicitud a la API de BigQuery.

Antes de probar este ejemplo, sigue las instrucciones de configuración de Java incluidas en la Guía de inicio rápido de BigQuery con bibliotecas cliente. A fin de obtener más información, consulta la documentación de referencia de la API de BigQuery para Java.

Ver en GitHub Comentarios

static final HttpTransport HTTP_TRANSPORT = new NetHttpTransport();
static final JsonFactory JSON_FACTORY = new JacksonFactory();

public static class Dataset {
  @Key private Map<String, String> labels;

  public Map<String, String> getLabels() {
    return this.labels;
  }

  public Dataset addLabel(String key, String value) {
    if (this.labels == null) {
      this.labels = new HashMap<>();
    }
    this.labels.put(key, value);
    return this;
  }
}

/**
 * Add or modify a label on a dataset.
 *
 * <p>See <a href="https://cloud.google.com/bigquery/docs/labeling-datasets">the BigQuery
 * documentation</a>.
 */
public static void labelDataset(
    String projectId, String datasetId, String labelKey, String labelValue) throws IOException {

  // Authenticate requests using Google Application Default credentials.
  GoogleCredential credential = GoogleCredential.getApplicationDefault();
  credential = credential.createScoped(Arrays.asList("https://www.googleapis.com/auth/bigquery"));

  // Get a new access token.
  // Note that access tokens have an expiration. You can reuse a token rather than requesting a
  // new one if it is not yet expired.
  credential.refreshToken();
  String accessToken = credential.getAccessToken();

  // Set the content of the request.
  Dataset dataset = new Dataset();
  dataset.addLabel(labelKey, labelValue);
  HttpContent content = new JsonHttpContent(JSON_FACTORY, dataset);

  // Send the request to the BigQuery API.
  String urlFormat =
      "https://www.googleapis.com/bigquery/v2/projects/%s/datasets/%s"
          + "?fields=labels&access_token=%s";
  GenericUrl url = new GenericUrl(String.format(urlFormat, projectId, datasetId, accessToken));
  HttpRequestFactory requestFactory = HTTP_TRANSPORT.createRequestFactory();
  HttpRequest request = requestFactory.buildPostRequest(url, content);
  request.setParser(JSON_FACTORY.createJsonObjectParser());

  // Workaround for transports which do not support PATCH requests.
  // See: http://stackoverflow.com/a/32503192/101923
  request.setHeaders(new HttpHeaders().set("X-HTTP-Method-Override", "PATCH"));
  HttpResponse response = request.execute();

  // Check for errors.
  if (response.getStatusCode() != 200) {
    throw new RuntimeException(response.getStatusMessage());
  }

  Dataset responseDataset = response.parseAs(Dataset.class);
  System.out.printf(
      "Updated label \"%s\" with value \"%s\"\n",
      labelKey, responseDataset.getLabels().get(labelKey));
}

Python

Antes de probar este ejemplo, sigue las instrucciones de configuración de Python incluidas en la Guía de inicio rápido de BigQuery con bibliotecas cliente. A fin de obtener más información, consulta la Documentación de referencia de la API de Python de BigQuery.

Ver en GitHub Comentarios

# from google.cloud import bigquery
# client = bigquery.Client()
# dataset_ref = client.dataset('my_dataset')
# dataset = client.get_dataset(dataset_ref)  # API request

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

dataset = client.update_dataset(dataset, ["labels"])  # API request

assert dataset.labels == labels

Agrega etiquetas de tabla y vista

Se puede agregar una etiqueta a una tabla o vista cuando se crea mediante alguna de estas acciones:

• Con el comando bq mk de la herramienta de línea de comandos
• Mediante una llamada tables.insert al método de la API

En esta página, se explica cómo agregar una etiqueta a una tabla o vista existente. Para obtener más información sobre cómo agregar una etiqueta cuando creas una tabla o vista, consulta cómo crear una tabla o crear una vista.

Se puede agregar una etiqueta cuando se crea una tabla o vista mediante alguna de estas acciones:

• Con GCP Console o la IU web de BigQuery
• Con el comando bq update de la herramienta de línea de comandos
• Mediante una llamada tables.patch al método de la API
• Con las bibliotecas cliente

Debido a que las vistas se tratan como recursos de tabla, debes usar el método tables.patch para modificar las vistas y las tablas.

Nota: Las etiquetas de tablas y vistas no se incluyen en los datos de facturación.

Permisos necesarios

Como mínimo, para agregar una etiqueta a una tabla o vista existente, debes tener los permisos de bigquery.tables.update y bigquery.tables.get. Las siguientes funciones predefinidas de Cloud IAM incluyen los permisos de bigquery.tables.update y bigquery.tables.get:

• bigquery.dataEditor
• bigquery.dataOwner
• bigquery.admin

Además, si un usuario tiene permisos de bigquery.datasets.create, cuando cree un conjunto de datos, se le otorgará el acceso bigquery.dataOwner. El acceso bigquery.dataOwner ofrece al usuario la capacidad de agregar etiquetas a las tablas y vistas de sus conjuntos de datos.

Para obtener más información sobre las funciones de Cloud IAM y los permisos en BigQuery, consulta los permisos y funciones predefinidas.

Agrega una etiqueta a una tabla o vista

Sigue estos pasos para agregar una etiqueta a una tabla o vista existente:

Console

1. Selecciona la tabla o vista en GCP Console.

2. Haz clic en la pestaña Detalles (Details).

   

3. Haz clic en el ícono de lápiz a la derecha de Etiquetas (Labels).

   

4. En el cuadro de diálogo Editar etiquetas (Edit labels), sigue estos pasos:

   • Haz clic en Agregar etiqueta (Add label).
   • Ingresa la clave y el valor para agregar una etiqueta. Para aplicar etiquetas adicionales, haz clic en Agregar etiqueta (Add label). Se puede usar cada clave solo una vez por conjunto de datos, pero puedes usar la misma clave en otros conjuntos de datos del mismo proyecto.
   • Modifica las claves o valores existentes para actualizar una etiqueta.
   • Haz clic en Actualizar (Update) para guardar los cambios.

DDL

Las declaraciones del lenguaje de definición de datos (DDL) te permiten crear y modificar tablas y vistas con la sintaxis de consulta de SQL estándar.

Obtén más información sobre el uso de las declaraciones del lenguaje de definición de datos.

Beta

Esta es una versión Beta de BigQuery support for the ALTER TABLE SET OPTIONS statement. En esta función se pueden producir cambios que generen incompatibilidad con versiones anteriores y is sujetas a ningún ANS o política de baja del servicio.

Para agregar una etiqueta mediante una declaración DDL en GCP Console, sigue estos pasos:

1. Haz clic en Redactar consulta nueva.

2. Escribe tu declaración de DDL en el área de texto Editor de consultas.

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

3. Haz clic en Ejecutar consulta.

IU clásica

1. En la IU web de BigQuery, selecciona la tabla o vista.

2. En la página de detalles, a la derecha de Etiquetas (Labels), haz clic en Editar (Edit). En este ejemplo, se muestran los detalles de una tabla.

   

3. En el cuadro de diálogo Editar etiquetas (Edit Labels), sigue estos pasos:

   • Ingresa la clave y el valor para agregar una etiqueta. Para aplicar etiquetas adicionales, haz clic en Agregar etiqueta (Add Label). Se puede usar cada clave solo una vez por tabla o vista, pero puedes usar la misma clave en tablas o vistas de otros conjuntos de datos.

   • Haz clic en OK (Aceptar).

     

CLI

Para agregar una etiqueta a una tabla o vista existente, ejecuta el comando bq update con la marca set_label. Repite la marca para agregar varias etiquetas.

Si la tabla o vista se encuentra en otro proyecto que no sea el predeterminado, debes agregar el ID del proyecto al conjunto de datos con el formato siguiente: project_id:dataset.

bq update \
--set_label key:value \
project_id:dataset.table_or_view

En el que:

• key:value corresponde a un par clave-valor para una etiqueta que deseas agregar. La clave debe ser exclusiva.
• project_id es el ID del proyecto.
• dataset es el conjunto de datos que contiene la tabla o vista que quieres etiquetar.
• table_or_view es el nombre de la tabla o vista que quieres etiquetar.

Ejemplos:

Para agregar una etiqueta de tabla que realice un seguimiento de los departamentos, ingresa el comando bq update y especifica department como la clave de etiqueta. Por ejemplo, para agregar una etiqueta department:shipping a mytable en tu proyecto predeterminado, ingresa el comando siguiente:

    bq update --set_label department:shipping mydataset.mytable

Para agregar una etiqueta de vista que realice un seguimiento de los departamentos, ingresa el comando bq update y especifica department como la clave de etiqueta. Por ejemplo, para agregar una etiqueta department:shipping a myview en tu proyecto predeterminado, ingresa el comando siguiente:

    bq update --set_label department:shipping mydataset.myview

Para agregar varias etiquetas a una tabla o vista, repite la marca set_label y especifica una clave exclusiva para cada etiqueta. Por ejemplo, para agregar las etiquetas department:shipping y cost_center:logistics a mytable a tu proyecto predeterminado, ingresa el comando siguiente:

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

API

Para agregar una etiqueta a una tabla o vista existente, llama al método tables.patch y propaga la propiedad labels para el recurso de tabla.

Debido a que las vistas se tratan como recursos de tabla, debes usar el método tables.patch para modificar las vistas y las tablas.

Debido a que el método tables.update reemplaza todo el recurso de conjunto de datos, el método tables.patch es preferible.

Go

Antes de probar este ejemplo, sigue las instrucciones de configuración de Go incluidas en la Guía de inicio rápido de BigQuery con bibliotecas cliente. A fin de obtener más información, consulta la Documentación de referencia de la API de Go de BigQuery.

Ver en GitHub Comentarios

// To run this sample, you will need to create (or reuse) a context and
// an instance of the bigquery client.  For example:
// import "cloud.google.com/go/bigquery"
// ctx := context.Background()
// client, err := bigquery.NewClient(ctx, "your-project-id")
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
}

Java

En esta muestra, se usa la biblioteca cliente HTTP de Google para Java a fin de enviar una solicitud a la API de BigQuery.

Antes de probar este ejemplo, sigue las instrucciones de configuración de Java incluidas en la Guía de inicio rápido de BigQuery con bibliotecas cliente. A fin de obtener más información, consulta la documentación de referencia de la API de BigQuery para Java.

Ver en GitHub Comentarios

public static class Table {
  @Key private Map<String, String> labels;

  public Map<String, String> getLabels() {
    return this.labels;
  }

  public Table addLabel(String key, String value) {
    if (this.labels == null) {
      this.labels = new HashMap<>();
    }
    this.labels.put(key, value);
    return this;
  }
}

/**
 * Add or modify a label on a table.
 *
 * <p>See <a href="https://cloud.google.com/bigquery/docs/labeling-datasets">the BigQuery
 * documentation</a>.
 */
public static void labelTable(
    String projectId,
    String datasetId,
    String tableId,
    String labelKey,
    String labelValue)
    throws IOException {

  // Authenticate requests using Google Application Default credentials.
  GoogleCredential credential = GoogleCredential.getApplicationDefault();
  credential = credential.createScoped(Arrays.asList("https://www.googleapis.com/auth/bigquery"));

  // Get a new access token.
  // Note that access tokens have an expiration. You can reuse a token rather than requesting a
  // new one if it is not yet expired.
  credential.refreshToken();
  String accessToken = credential.getAccessToken();

  // Set the content of the request.
  Table table = new Table();
  table.addLabel(labelKey, labelValue);
  HttpContent content = new JsonHttpContent(JSON_FACTORY, table);

  // Send the request to the BigQuery API.
  String urlFormat =
      "https://www.googleapis.com/bigquery/v2/projects/%s/datasets/%s/tables/%s"
          + "?fields=labels&access_token=%s";
  GenericUrl url =
      new GenericUrl(String.format(urlFormat, projectId, datasetId, tableId, accessToken));
  HttpRequestFactory requestFactory = HTTP_TRANSPORT.createRequestFactory();
  HttpRequest request = requestFactory.buildPostRequest(url, content);
  request.setParser(JSON_FACTORY.createJsonObjectParser());

  // Workaround for transports which do not support PATCH requests.
  // See: http://stackoverflow.com/a/32503192/101923
  request.setHeaders(new HttpHeaders().set("X-HTTP-Method-Override", "PATCH"));
  HttpResponse response = request.execute();

  // Check for errors.
  if (response.getStatusCode() != 200) {
    throw new RuntimeException(response.getStatusMessage());
  }

  Table responseTable = response.parseAs(Table.class);
  System.out.printf(
      "Updated label \"%s\" with value \"%s\"\n",
      labelKey, responseTable.getLabels().get(labelKey));
}

Python

Antes de probar este ejemplo, sigue las instrucciones de configuración de Python incluidas en la Guía de inicio rápido de BigQuery con bibliotecas cliente. A fin de obtener más información, consulta la Documentación de referencia de la API de Python de BigQuery.

Ver en GitHub Comentarios

# from google.cloud import bigquery
# client = bigquery.Client()
# table_ref = client.dataset('my_dataset').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

Cómo agregar etiquetas de trabajo

Las etiquetas se pueden agregar a los trabajos de consulta mediante la línea de comandos con la marca --label de la herramienta de línea de comandos. La herramienta de línea de comandos admite que se agreguen etiquetas solo a trabajos de consulta.

También puedes agregar una etiqueta a un trabajo cuando se envía a través de la API si especificas la propiedad labels en la configuración del trabajo cuando llamas al método jobs.insert. La API se puede usar para agregar etiquetas a cualquier tipo de trabajo.

No puedes agregar ni actualizar etiquetas en trabajos pendientes, en ejecución o completados.

Cuando agregas una etiqueta a un trabajo, la etiqueta se incluye en tus datos de facturación.

Permisos necesarios

No se requieren permisos especiales para agregar una etiqueta a un trabajo. Si tienes permisos de bigquery.jobs.create, puedes agregar una etiqueta a tu trabajo cuando lo envíes.

Como mínimo, para ejecutar un trabajo, debes tener permisos de bigquery.jobs.create. Se requieren permisos bigquery.jobs.create para trabajos que BigQuery crea de forma automática y trabajos que ejecutas de manera programática.

Las siguientes funciones predefinidas de Cloud IAM incluyen los permisos de bigquery.jobs.create:

• bigquery.user
• bigquery.jobUser
• bigquery.admin

Para obtener más información sobre las funciones de Cloud IAM y los permisos en BigQuery, consulta los permisos y funciones predefinidas.

Agrega una etiqueta a un trabajo

Para agregar una etiqueta a un trabajo, considera ten en cuenta la información siguiente:

Console

GCP Console no admite agregar etiquetas a los trabajos.

IU clásica

La IU web clásica de BigQuery no admite que se agreguen etiquetas a los trabajos.

CLI

Ejecuta el comando bq query con la marca --label para agregar una etiqueta a un trabajo de consulta. Repite la marca para agregar varias etiquetas. La marca --nouse_legacy_sql indica que tu consulta tiene la sintaxis SQL estándar.

bq query --label key:value --nouse_legacy_sql 'query'

En el que:

• key:value corresponde a un par clave-valor para una etiqueta que deseas agregar al trabajo de consulta. La clave debe ser exclusiva. A fin de agregar varias etiquetas a un trabajo de consulta, repite la marca --label y especifica una clave exclusiva para cada etiqueta.
• query es una consulta de SQL estándar válida.

Ejemplos:

Para agregar una etiqueta a un trabajo de consulta, ingresa lo siguiente:

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

A fin de agregar varias etiquetas a un trabajo de consulta, repite la marca --label y especifica una clave exclusiva para cada etiqueta. Por ejemplo, para agregar las etiquetas department:shipping y cost_center:logistics a un trabajo de consulta, ingresa la información siguiente:

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

API

Si deseas agregar una etiqueta a un trabajo, llama al método jobs.insert y propaga la propiedad labels para la configuración del trabajo. Puedes usar la API para agregar etiquetas a cualquier tipo de trabajo.

Agrega un rótulo identificador

Una etiqueta que tiene una clave con un valor vacío se usa como un rótulo identificador. Puedes crear una etiqueta nueva sin valor o convertir una que ya exista en una etiqueta.

Las etiquetas pueden ser útiles en situaciones en las que etiquetes un recurso, pero que no sea necesario el formato clave-valor. Por ejemplo, si tienes una tabla que contiene datos de prueba que usan varios grupos (asistencia, desarrollo, etcétera), puedes agregar un rótulo identificador test_data a la tabla para identificarla.

Para agregar un rótulo identificador, sigue estos pasos:

Console

1. En GCP Console, selecciona el recurso adecuado (un conjunto de datos, tabla o vista).

2. En el caso de los conjuntos de datos, la página de detalles de conjuntos de datos se abre de forma automática. Para las tablas y vistas, haz clic en Detalles (Details) a fin de abrir la página de detalles.

   

3. En la página de detalles, haz clic en el ícono de lápiz a la derecha de Etiquetas (Labels).

   

4. En el cuadro de diálogo Editar etiquetas (Edit labels), sigue estos pasos:

   • Haz clic en Agregar etiqueta (Add label).
   • Ingresa una clave nueva y deja el valor en blanco. Para aplicar rótulos identificadores adicionales, haz clic en Agregar etiqueta (Add label) y repite el proceso.
   • Haz clic en Actualizar (Update) para guardar los cambios.

DDL

Las declaraciones del lenguaje de definición de datos (DDL) te permiten crear y modificar tablas y vistas con la sintaxis de consulta de SQL estándar.

Obtén más información sobre el uso de las declaraciones del lenguaje de definición de datos.

Beta

Esta es una versión Beta de BigQuery support for the ALTER TABLE SET OPTIONS statement. En esta función se pueden producir cambios que generen incompatibilidad con versiones anteriores y is sujetas a ningún ANS o política de baja del servicio.

Para agregar un rótulo identificador mediante una declaración DDL en GCP Console, sigue estos pasos:

1. Haz clic en Redactar consulta nueva.

2. Escribe tu declaración de DDL en el área de texto Editor de consultas.

    ALTER TABLE mydataset.mytable
    SET OPTIONS (
      labels=[("tag1", ""), ("tag2", "")]
    )
    

3. Haz clic en Ejecutar consulta.

IU clásica

1. En la IU web, selecciona el recurso adecuado (un conjunto de datos, una tabla o una vista).

2. En el caso de los conjuntos de datos, la página de detalles de conjuntos de datos se abre de forma automática. Para las tablas y vistas, haz clic en Detalles a fin de abrir la página de detalles.

3. En la página de detalles, a la derecha de Etiquetas (Labels), haz clic en Editar (Edit).

4. En el cuadro de diálogo Editar etiquetas (Edit Labels), sigue estos pasos:

   • Ingresa una clave nueva y deja el valor en blanco. Para aplicar etiquetas adicionales, haz clic en Agregar etiqueta.

   • Haz clic en OK (Aceptar).

     

CLI

Usa el comando bq update con la marca set_label para agregar una etiqueta a un recurso existente. Especifica la clave, seguida de dos puntos, pero no especifiques el valor.

bq update --set_label key: resource_id

En el que:

• key es la clave de etiqueta que deseas usar como rótulo identificador.
• resource_id es un nombre válido de conjunto de datos, tabla o vista. Si el recurso se encuentra en otro proyecto que no sea el predeterminado, debes agregar el ID del proyecto con el formato siguiente: project_id:dataset.

Ejemplos:

Ingresa el siguiente comando a fin de crear una etiqueta test_data para mydataset.mytable. mydataset se encuentra en tu proyecto predeterminado.

bq update --set_label test_data: mydataset

API

Llama al método datasets.patch o tables.patch y agrega etiquetas con el valor configurado como la string vacía ("") al recurso de conjunto de datos o al recurso de tabla. Puedes convertir las etiquetas personalizadas existentes en rótulos identificadores si reemplazas sus valores con la string vacía.

Debido a que las vistas se tratan como recursos de tabla, debes usar el método tables.patch para modificar las vistas y las tablas. Además, debido a que el método tables.update reemplaza todo el recurso de conjunto de datos, el método tables.patch es preferible.

Pasos siguientes

• Obtén más información sobre cómo ver etiquetas en los recursos de BigQuery.
• Obtén más información sobre cómo actualizar etiquetas en los recursos de BigQuery.
• Obtén más información sobre cómo filtrar recursos mediante etiquetas.
• Obtén más información sobre cómo borrar etiquetas en los recursos de BigQuery.
• Aprende a usar etiquetas en la documentación de Resource Manager.