En esta página, se explica cómo visualizar las etiquetas de los recursos de BigQuery.
Descripción general
Puedes ver etiquetas en estas situaciones:
- Usa Cloud Console.
- Usar el comando
bq show
de la herramienta de línea de comandos debq
- Con una llamada a los métodos
datasets.get
otables.get
de la API - Con las 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
. En las siguientes funciones predefinidas de IAM, se 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
, se le otorga el acceso bigquery.dataOwner
cuando crea un conjunto de datos.
El acceso bigquery.dataOwner
brinda al usuario la capacidad de obtener información sobre un conjunto de datos.
Para obtener más información sobre las funciones y los permisos de IAM en BigQuery, consulta Funciones y permisos predefinidos.
Permisos de tabla y vista
Como mínimo, para obtener información sobre las tablas o vistas, debes tener permisos bigquery.tables.get
. En todas las funciones predefinidas de IAM, se incluyen permisos bigquery.tables.get
, excepto en las funciones bigquery.user
y bigquery.jobUser
.
Además, si un usuario tiene permisos bigquery.datasets.create
, se le otorga el acceso bigquery.dataOwner
cuando crea un conjunto de datos.
El acceso bigquery.dataOwner
brinda 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 y los permisos de IAM en BigQuery, consulta Funciones y permisos predefinidos.
Permisos de trabajo
Como mínimo, para obtener datos y metadatos del trabajo, debes tener permisos bigquery.jobs.get
. En la siguiente función predefinida de IAM, se incluyen permisos bigquery.jobs.get
:
bigquery.admin
Si otorgas a una cuenta la función de bigquery.admin
, el usuario podrá visualizar todos los datos de trabajos del proyecto sin importar quién haya enviado los trabajos.
A las siguientes funciones se les otorgan permisos bigquery.jobs.get
para trabajos autocreados. Estos usuarios solo pueden ver los datos de los trabajos que envían:
bigquery.user
bigquery.jobUser
Para obtener más información sobre las funciones y permisos de IAM en BigQuery, consulta Control de acceso.
Visualiza etiquetas de conjuntos de datos, tablas y vistas
Sigue estos pasos para visualizar etiquetas de un recurso:
Console
En Cloud Console, selecciona un conjunto de datos, tabla o vista. Las etiquetas de trabajo no se pueden visualizar en Cloud Console.
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 Details (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.
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, debes agregar el ID del proyecto al comando con el siguiente formato: [PROJECT_ID]:[DATASET]
. A fin de facilitar la lectura, puedes configurar la marca --format
en pretty
para controlar el resultado.
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 siguiente comando a fin de mostrar etiquetas para mydataset
en tu proyecto predeterminado.
bq show --format=pretty mydataset
El resultado se verá de la siguiente manera:
+-----------------+--------------------------------------------------------+---------------------+ | Last modified | ACLs | Labels | +-----------------+--------------------------------------------------------+---------------------+ | 11 Jul 19:34:34 | Owners: | department:shipping | | | projectOwners, | | | | Writers: | | | | projectWriters | | | | Readers: | | | | projectReaders | | +-----------------+--------------------------------------------------------+---------------------+
Ingresa el siguiente comando a fin de mostrar etiquetas para mydataset.mytable
.
mydataset
está en myotherproject
, no en tu proyecto predeterminado.
bq show --format=pretty myotherproject:mydataset.mytable
En el caso de una tabla agrupada en clústeres, el aspecto del resultado será el 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
Realiza una llamada 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
para visualizar las etiquetas de varios conjuntos de datos o tables.list
para visualizar 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
a fin de visualizar la información de etiquetas para las vistas y las tablas.
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Go de BigQuery.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de BigQuery para Java.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la Documentación de referencia de la API de Node.js de BigQuery.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración para Python incluidas en la Guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Python de BigQuery.
Visualiza etiquetas de la tabla
Comienza a usarlo
Antes de probar este ejemplo, sigue las instrucciones de configuración para Go que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Go de BigQuery.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración para Java que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de BigQuery para Java.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración para Node.js que se encuentran en la guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la Documentación de referencia de la API de Node.js de BigQuery.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración para Python incluidas en la Guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Python de BigQuery.
Antes de probar esta muestra, sigue las instrucciones de configuración para Python incluidas en la Guía de inicio rápido de BigQuery sobre cómo usar bibliotecas cliente. Si deseas obtener más información, consulta la documentación de referencia de la API de Python de BigQuery.
Visualiza etiquetas de trabajo
Después de enviar un trabajo, las etiquetas del trabajo no aparecen en Cloud Console. Para ver las etiquetas de un trabajo, emite el comando bq show -j [JOB_ID]
o usa la API o las bibliotecas cliente.
Console
No puedes ver las etiquetas de trabajo con Cloud Console.
bq
Para ver las etiquetas de un trabajo de consulta mediante la herramienta de línea de comandos de bq
, ingresa el comando bq show -j
con el ID del trabajo de consulta. La marca --format
se puede usar para controlar el resultado. Por ejemplo, si tu trabajo de consulta tiene el ID de tarea bqjob_r1234d57f78901_000023746d4q12_1
, ingresa el siguiente comando:
bq show -j --format=pretty bqjob_r1234d57f78901_000023746d4q12_1
El resultado debe tener el siguiente 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
Realiza una llamada al método jobs.get
. En la respuesta, se incluyen todas las etiquetas asociadas con ese recurso.
Pasos siguientes
- Aprende a agregar etiquetas a los recursos de BigQuery.
- Obtén más información sobre cómo actualizar etiquetas en los recursos de BigQuery.
- Aprende a filtrar recursos mediante etiquetas.
- Aprende a borrar etiquetas de los recursos de BigQuery.
- Aprende a usar etiquetas en la documentación de Resource Manager.