Visualiza etiquetas

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

Descripción general

Puedes ver etiquetas en estas situaciones:

  • Cuando usas GCP Console o la IU web de BigQuery clásica
  • Cuando usas el comando bq show de la herramienta de línea de comandos
  • Cuando llamas a los métodos datasets.get o tables.get de la API
  • Cuando usas bibliotecas cliente.

Debido a que las vistas se tratan como recursos de tabla, debes usar el método tables.get para obtener información de etiquetas de las vistas y las tablas.

Permisos necesarios

Los permisos necesarios para ver las etiquetas dependen del tipo de recurso al que accedas.

Permisos del conjunto de datos

Como mínimo, para obtener información sobre un conjunto de datos, debes tener permisos bigquery.datasets.get. Las siguientes funciones predefinidas de Cloud IAM incluyen los permisos bigquery.datasets.get:

  • bigquery.user
  • bigquery.metadataViewer
  • bigquery.dataViewer
  • bigquery.dataOwner
  • bigquery.dataEditor
  • bigquery.admin

Además, si un usuario tiene permisos bigquery.datasets.create, cuando cree un conjunto de datos, se le otorgará acceso bigquery.dataOwner. El acceso bigquery.dataOwner ofrece al usuario la capacidad de obtener información sobre un conjunto de datos.

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

Permisos de tabla y vista

Como mínimo, para obtener información sobre tablas o vistas, debes tener permisos de bigquery.tables.get. Todas las funciones predefinidas de Cloud IAM incluyen los permisos bigquery.tables.get excepto bigquery.user y bigquery.jobUser.

Además, si un usuario tiene permisos bigquery.datasets.create, cuando cree un conjunto de datos, se le otorgará acceso bigquery.dataOwner. El acceso bigquery.dataOwner ofrece al usuario la capacidad de obtener información sobre tablas y vistas en un conjunto de datos.

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

Permisos de trabajo

Como mínimo, para obtener datos y metadatos de trabajo, debes tener permisos bigquery.jobs.get. La siguiente función predefinida de Cloud IAM incluye los permisos bigquery.jobs.get:

  • bigquery.admin

Si otorgas a una cuenta la función de bigquery.admin, el usuario puede ver todos los datos de trabajos en el proyecto, sin importar quién envió el trabajo.

A las siguientes funciones se les otorgan permisos bigquery.jobs.get para trabajos autocreados. Estos usuarios solo pueden ver los datos de trabajos de los trabajos que envían:

  • bigquery.user
  • bigquery.jobUser

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

Visualiza etiquetas de conjunto de datos, tabla y vista

Sigue estos pasos para visualizar etiquetas de un recurso:

Console

  1. En GCP Console, selecciona un conjunto de datos, tabla o vista. Las etiquetas de trabajo no se pueden visualizar en GCP Console.

  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. La información de la etiqueta aparece en la tabla de información del recurso.

    Detalles de la tabla

IU clásica

  1. En la IU web, selecciona un conjunto de datos, tabla o vista. Las etiquetas de trabajo no se pueden ver en la IU web clásica.

  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. La información de la etiqueta aparece en la tabla de información del recurso.

CLI

Usa el comando bq show con el ID de recurso. La marca --format se puede usar para controlar el resultado. Si el recurso se encuentra en otro proyecto que no sea el predeterminado, agrega el ID del proyecto en el siguiente formato: [PROJECT_ID]:[DATASET]. Para facilitar la lectura, el resultado se puede controlar si configuras la marca --format a pretty.

bq show --format=pretty [RESOURCE_ID]

Donde [RESOURCE_ID] es un conjunto de datos válido, tabla, vista o ID de trabajo.

Ejemplos:

Ingresa el comando siguiente para mostrar las etiquetas de mydataset en tu proyecto predeterminado.

bq show --format=pretty mydataset

El resultado se verá de la manera siguiente:

+-----------------+--------------------------------------------------------+---------------------+
|  Last modified  |                          ACLs                          |       Labels        |
+-----------------+--------------------------------------------------------+---------------------+
| 11 Jul 19:34:34 | Owners:                                                | department:shipping |
|                 |   projectOwners,                                       |                     |
|                 | Writers:                                               |                     |
|                 |   projectWriters                                       |                     |
|                 | Readers:                                               |                     |
|                 |   projectReaders                                       |                     |
+-----------------+--------------------------------------------------------+---------------------+

Ingresa el comando siguiente para mostrar las etiquetas de mydataset.mytable. mydataset se encuentra en myotherproject, no en tu proyecto predeterminado.

bq show --format=pretty myotherproject:mydataset.mytable

El resultado se verá de la siguiente manera para una tabla en clúster:

+-----------------+------------------------------+------------+-------------+-----------------+------------------------------------------------+------------------+---------+
|  Last modified  |            Schema            | Total Rows | Total Bytes |   Expiration    |               Time Partitioning                | Clustered Fields | Labels  |
+-----------------+------------------------------+------------+-------------+-----------------+------------------------------------------------+------------------+---------+
| 25 Jun 19:28:14 | |- timestamp: timestamp      | 0          | 0           | 25 Jul 19:28:14 | DAY (field: timestamp, expirationMs: 86400000) | customer_id      | org:dev |
|                 | |- customer_id: string       |            |             |                 |                                                |                  |         |
|                 | |- transaction_amount: float |            |             |                 |                                                |                  |         |
+-----------------+------------------------------+------------+-------------+-----------------+------------------------------------------------+------------------+---------+

API

Llame al método datasets.get o al método tables.get. En la respuesta, se incluyen todas las etiquetas asociadas con ese recurso.

Como alternativa, puedes usar datasets.list a fin de ver las etiquetas de varios conjuntos de datos o tables.list a fin de ver las etiquetas de varias tablas y vistas.

Debido a que las vistas se tratan como recursos de tabla, debes usar los métodos tables.get y tables.list para ver información de las etiquetas de las vistas y las tablas.

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.

// 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")
meta, err := client.Dataset(datasetID).Metadata(ctx)
if err != nil {
	return err
}
fmt.Fprintf(w, "Dataset %s labels:\n", datasetID)
if len(meta.Labels) == 0 {
	fmt.Fprintln(w, "Dataset has no labels defined.")
	return nil
}
for k, v := range meta.Labels {
	fmt.Fprintf(w, "\t%s:%s\n", k, v)
}

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.

# from google.cloud import bigquery
# client = bigquery.Client()
# dataset_id = 'my_dataset'

dataset_ref = client.dataset(dataset_id)
dataset = client.get_dataset(dataset_ref)  # API request

# View dataset labels
print("Dataset ID: {}".format(dataset_id))
print("Labels:")
if dataset.labels:
    for label, value in dataset.labels.items():
        print("\t{}: {}".format(label, value))
else:
    print("\tDataset has no labels defined.")

Visualiza etiquetas de trabajo

Después de enviar un trabajo, las etiquetas del trabajo no aparecen en la GCP Console o en la IU web clásica de BigQuery. Si deseas ver las etiquetas en un trabajo, emita el comando bq show -j [JOB_ID] o usa la API o las bibliotecas cliente.

Console

No puedes ver las etiquetas de trabajo con GCP Console.

IU clásica

No puedes ver las etiquetas del trabajo mediante la IU web de BigQuery.

CLI

Ingresa el comando bq show -j con el ID de trabajo del trabajo de consulta a fin de ver tus etiquetas con la herramienta de línea de comandos bq. Se puede usar la marca --format para controlar los resultados. Por ejemplo, si tu trabajo de consulta tiene el ID de trabajo bqjob_r1234d57f78901_000023746d4q12_1, ingresa el comando siguiente:

bq show -j --format=pretty bqjob_r1234d57f78901_000023746d4q12_1

El resultado debe verse de la siguiente manera:

+----------+---------+-----------------+----------+-------------------+-----------------+--------------+----------------------+
| Job Type |  State  |   Start Time    | Duration |    User Email     | Bytes Processed | Bytes Billed |        Labels        |
+----------+---------+-----------------+----------+-------------------+-----------------+--------------+----------------------+
| query    | SUCCESS | 03 Dec 15:00:41 | 0:00:00  | email@example.com | 255             | 10485760     | department:shipping  |
|          |         |                 |          |                   |                 |              | costcenter:logistics |
+----------+---------+-----------------+----------+-------------------+-----------------+--------------+----------------------+

API

Llama al método jobs.get. En la respuesta, se incluyen todas las etiquetas asociadas con ese recurso.

Pasos siguientes

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.