En este documento se describe cómo enumerar vistas en BigQuery.
Puedes enumerar vistas en conjuntos de datos de las siguientes formas:
- Mediante Cloud Console o la IU web clásica de BigQuery
- Mediante el comando
bq ls
de la CLI - Con una llamada al método
tables.list
de la API - Con las bibliotecas cliente
Permisos necesarios
Como mínimo, para enumerar las vistas en un conjunto de datos, debes tener permisos bigquery.tables.list
. Las siguientes funciones predefinidas de Cloud IAM incluyen los permisos bigquery.tables.list
:
bigquery.user
bigquery.metadataViewer
bigquery.dataViewer
bigquery.dataOwner
bigquery.dataEditor
bigquery.admin
Para obtener más información sobre las funciones de Cloud IAM y los permisos en BigQuery, consulta la sección sobre el control de acceso.
Enumera las vistas
El proceso para hacer una lista de las vistas es igual al proceso para hacer una lista de las tablas.
Para enumerar las vistas en un conjunto de datos, sigue estos pasos:
Console
En el panel de navegación, en la sección Recursos, expande el proyecto y haz clic en un conjunto de datos. De esta manera, se muestran las tablas y vistas en el conjunto de datos.
Desplázate por la lista para ver las tablas en el conjunto de datos. Las tablas y las vistas están identificadas con íconos diferentes.
IU clásica
En la IU web de BigQuery, en el panel de navegación, haz clic en la flecha azul a la izquierda de tu conjunto de datos para expandirlo o haz doble clic en el nombre del conjunto de datos. De esta manera, se muestran las tablas y vistas en el conjunto de datos.
Desplázate por la lista para ver las tablas en el conjunto de datos. Las tablas y las vistas están identificadas con íconos diferentes.
CLI
Ejecuta el comando bq ls
. Se puede usar la marca --format
para controlar el resultado. Si enumeras vistas en un proyecto que no es el predeterminado, agrega el ID del proyecto al conjunto de datos en el siguiente formato: project_id:dataset
.
bq ls --format=pretty project_id:dataset
Donde:
- project_id es el ID del proyecto.
- dataset es el nombre del conjunto de datos.
Cuando ejecutas el comando, el campo Type
muestra TABLE
o VIEW
. Por ejemplo:
+-------------------------+-------+----------------------+-------------------+ | tableId | Type | Labels | Time Partitioning | +-------------------------+-------+----------------------+-------------------+ | mytable | TABLE | department:shipping | | | myview | VIEW | | | +-------------------------+-------+----------------------+-------------------+
Ejemplos:
Ingresa el siguiente comando para enumerar las vistas en el conjunto de datos mydataset
en tu proyecto predeterminado.
bq ls --format=pretty mydataset
Ingresa el siguiente comando para enumerar las vistas en el conjunto de datos mydataset
en myotherproject
.
bq ls --format=pretty myotherproject:mydataset
API
Para enumerar vistas con la API, llama al método tables.list
.
Go
Antes de probar este ejemplo, sigue las instrucciones de configuración de Go incluidas en la Guía de inicio rápido: usa bibliotecas cliente. A fin de obtener más información, consulta la documentación de referencia de la API de BigQuery para Go.
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración de Go incluidas en la Guía de inicio rápido: usa bibliotecas cliente. A fin de obtener más información, consulta la documentación de referencia de la API de BigQuery para Go.
Próximos pasos
- Para obtener información sobre cómo crear vistas, consulta Crea vistas.
- Para obtener información sobre cómo crear una vista autorizada, consulta Crea vistas autorizadas.
- Para conocer el método sobre cómo obtener metadatos de vistas, consulta Obtén información sobre las vistas.
- Para obtener más información sobre cómo actualizar vistas, consulta esta página sobre cómo actualizar vistas.
- Para obtener más información sobre cómo administrar vistas, consulta Administra vistas.