Ver etiquetas
En esta página se explica cómo ver las etiquetas de los recursos de BigQuery.
Puedes ver las etiquetas de las siguientes formas:
- Usar la Google Cloud consola
- Consultar
INFORMATION_SCHEMA
vistas - Usar el comando
bq show
de la herramienta de línea de comandos bq - Llamar a los métodos de la API
datasets.get
otables.get
- Usar las bibliotecas de cliente
Como las vistas se tratan como recursos de tabla, se usa el método tables.get
para obtener información de las etiquetas de las vistas y las tablas.
Antes de empezar
Concede roles de gestión de identidades y accesos (IAM) que proporcionen a los usuarios los permisos necesarios para realizar cada tarea de este documento.
Permisos obligatorios
Los permisos necesarios para ver etiquetas dependen de los tipos de recursos a los que puedes acceder. Para realizar las tareas que se describen en este documento, necesitas los siguientes permisos.
Permisos para ver los detalles del conjunto de datos
Para ver los detalles de un conjunto de datos, necesitas el permiso de gestión de identidades y accesos bigquery.datasets.get
.
Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye los permisos que necesitas para ver los detalles de un conjunto de datos:
roles/bigquery.user
roles/bigquery.metadataViewer
roles/bigquery.dataViewer
roles/bigquery.dataOwner
roles/bigquery.dataEditor
roles/bigquery.admin
Además, si tienes el permiso bigquery.datasets.create
, puedes ver los detalles de los conjuntos de datos que crees.
Para obtener más información sobre los roles y permisos de IAM en BigQuery, consulta el artículo sobre funciones y permisos predefinidos.
Permisos para ver los detalles de una tabla o una vista
Para ver los detalles de una tabla o una vista, necesitas el permiso de gestión de identidades y accesos bigquery.tables.get
.
Todos los roles de gestión de identidades y accesos predefinidos incluyen los permisos que necesitas para ver una tabla o sus detalles, excepto roles/bigquery.user
y roles/bigquery.jobUser
.
Además, si tienes el permiso bigquery.datasets.create
, puedes ver los detalles de las tablas y las vistas de los conjuntos de datos que crees.
Para obtener más información sobre los roles y permisos de IAM en BigQuery, consulta el artículo sobre funciones y permisos predefinidos.
Permisos para ver los detalles de los trabajos
Para ver los detalles de un trabajo, necesitas el permiso bigquery.jobs.get
de gestión de identidades y accesos.
Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye los permisos que necesitas para ver los detalles de los trabajos:
roles/bigquery.admin
(te permite ver los detalles de todos los trabajos del proyecto)roles/bigquery.user
(te permite ver los detalles de tus trabajos)roles/bigquery.jobUser
(te permite ver los detalles de tus trabajos)
Para obtener más información sobre los roles y permisos de IAM en BigQuery, consulta el artículo sobre funciones y permisos predefinidos.
Ver etiquetas de conjuntos de datos, tablas y vistas
Para ver las etiquetas de un recurso, selecciona una de las siguientes opciones:
Consola
En el caso de los conjuntos de datos, se abre automáticamente la página de detalles del conjunto de datos. En el caso de las tablas y las vistas, haz clic en Detalles para abrir la página de detalles. La información de la etiqueta aparece en la tabla de información del recurso.
SQL
Consulta la vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS
para ver las etiquetas de un conjunto de datos o la vista INFORMATION_SCHEMA.TABLE_OPTIONS
para ver las etiquetas de una tabla. Por ejemplo, la siguiente consulta de SQL devuelve las etiquetas del conjunto de datos llamado mydataset
:
En la Google Cloud consola, ve a la página BigQuery.
En el editor de consultas, introduce la siguiente instrucción:
SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_OPTIONS WHERE schema_name = 'mydataset' AND option_name = 'labels';
Haz clic en
Ejecutar.
Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.
bq
Usa el comando bq show
con el ID del recurso. La marca --format
se puede usar para controlar el resultado. Si el recurso está en un proyecto que no es el predeterminado, añade el ID del proyecto con el siguiente formato:
[PROJECT_ID]:[DATASET]
. Para que el resultado sea más legible, se controla configurando la marca --format
en pretty
.
bq show --format=pretty [RESOURCE_ID]
Donde [RESOURCE_ID]
es un ID de conjunto de datos, tabla, vista o tarea válido.
Ejemplos:
Introduce el siguiente comando para mostrar las etiquetas de mydataset
en tu proyecto predeterminado.
bq show --format=pretty mydataset
La salida tiene este aspecto:
+-----------------+--------------------------------------------------------+---------------------+ | Last modified | ACLs | Labels | +-----------------+--------------------------------------------------------+---------------------+ | 11 Jul 19:34:34 | Owners: | department:shipping | | | projectOwners, | | | | Writers: | | | | projectWriters | | | | Readers: | | | | projectReaders | | +-----------------+--------------------------------------------------------+---------------------+
Introduce el siguiente comando para mostrar las etiquetas de mydataset.mytable
.
mydataset
está en myotherproject
, no en tu proyecto predeterminado.
bq show --format=pretty myotherproject:mydataset.mytable
La salida de una tabla agrupada es similar a la siguiente:
+-----------------+------------------------------+------------+-------------+-----------------+------------------------------------------------+------------------+---------+ | 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
Llama al método datasets.get
o al método tables.get
. La respuesta incluye todas las etiquetas asociadas a ese recurso.
También puede usar datasets.list
para ver las etiquetas de varios conjuntos de datos o tables.list
para ver las etiquetas de varias tablas y vistas.
Como las vistas se tratan como recursos de tabla, puedes usar los métodos tables.get
y tables.list
para ver la información de las etiquetas de las vistas y las tablas.
Go
Antes de probar este ejemplo, sigue las Goinstrucciones de configuración de la guía de inicio rápido de BigQuery con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Go de BigQuery.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Java
Antes de probar este ejemplo, sigue las Javainstrucciones de configuración de la guía de inicio rápido de BigQuery con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java de BigQuery.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Node.js
Antes de probar este ejemplo, sigue las Node.jsinstrucciones de configuración de la guía de inicio rápido de BigQuery con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js de BigQuery.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Python
Antes de probar este ejemplo, sigue las Pythoninstrucciones de configuración de la guía de inicio rápido de BigQuery con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Python de BigQuery.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Ver etiquetas de tablas
Go
Antes de probar este ejemplo, sigue las Goinstrucciones de configuración de la guía de inicio rápido de BigQuery con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Go de BigQuery.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Java
Antes de probar este ejemplo, sigue las Javainstrucciones de configuración de la guía de inicio rápido de BigQuery con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Java de BigQuery.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Node.js
Antes de probar este ejemplo, sigue las Node.jsinstrucciones de configuración de la guía de inicio rápido de BigQuery con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Node.js de BigQuery.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Python
Antes de probar este ejemplo, sigue las Pythoninstrucciones de configuración de la guía de inicio rápido de BigQuery con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Python de BigQuery.
Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.
Ver etiquetas de tareas
Para ver las etiquetas de un trabajo, selecciona una de las siguientes opciones:
SQL
Consulta las vistasINFORMATION_SCHEMA.JOB_BY_*
para ver las etiquetas de un trabajo. Por ejemplo, la siguiente consulta de SQL devuelve el texto de la consulta y las etiquetas de los trabajos enviados por el usuario actual en el proyecto actual:
En la Google Cloud consola, ve a la página BigQuery.
En el editor de consultas, introduce la siguiente instrucción:
SELECT query, labels FROM INFORMATION_SCHEMA.JOBS_BY_USER;
Haz clic en
Ejecutar.
Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.
bq
Para ver las etiquetas de una tarea de consulta con la herramienta de línea de comandos bq, introduce el comando bq show -j
con el ID de tarea de la consulta. La marca --format
se puede usar para controlar la salida. Por ejemplo, si tu tarea de consulta tiene el ID de tarea bqjob_r1234d57f78901_000023746d4q12_1
, introduce el siguiente comando:
bq show -j --format=pretty bqjob_r1234d57f78901_000023746d4q12_1
La salida debería tener este aspecto:
+----------+---------+-----------------+----------+-------------------+-----------------+--------------+----------------------+ | 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
. La respuesta incluye todas las etiquetas asociadas a ese recurso.
Ver etiquetas de reserva
Para ver las etiquetas de una reserva, selecciona una de las siguientes opciones:
SQL
Consulta las INFORMATION_SCHEMA.RESERVATIONS
vistas para ver las etiquetas de
una reserva. Por ejemplo, la siguiente consulta SQL devuelve el nombre y las etiquetas de la reserva:
En la Google Cloud consola, ve a la página BigQuery.
En el editor de consultas, introduce la siguiente instrucción:
SELECT reservation_name, labels FROM INFORMATION_SCHEMA.RESERVATIONS WHERE reservation_name = RESERVATION_NAME;
Haz los cambios siguientes:
RESERVATION_NAME
: el nombre de la reserva.
Haz clic en
Ejecutar.
Para obtener más información sobre cómo ejecutar consultas, consulta Ejecutar una consulta interactiva.
bq
Usa el comando bq show
para ver las etiquetas de reserva.
bq show --format=prettyjson --reservation=true --location=LOCATION RESERVATION_NAME
Haz los cambios siguientes:
LOCATION
: la ubicación de la reserva.RESERVATION_NAME
: el nombre de la reserva.
El resultado es similar al siguiente:
{ "autoscale": { "maxSlots": "100" }, "creationTime": "2023-10-26T15:16:28.196940Z", "edition": "ENTERPRISE", "labels": { "department": "shipping" }, "name": "projects/myproject/locations/US/reservations/myreservation", "updateTime": "2025-06-05T19:37:28.125914Z" }
Siguientes pasos
- Consulta cómo añadir etiquetas a recursos de BigQuery.
- Consulta cómo actualizar etiquetas en recursos de BigQuery.
- Consulta cómo filtrar recursos mediante etiquetas.
- Consulta cómo eliminar etiquetas de recursos de BigQuery.
- Consulta información sobre el uso de etiquetas en la documentación de Resource Manager.