Gestionar réplicas de vistas materializadas

En este documento se describe cómo gestionar réplicas de vistas materializadas en BigQuery.

La gestión de réplicas de vistas materializadas de BigQuery incluye las siguientes operaciones:

• Lista de réplicas de vistas materializadas
• Obtener información sobre las réplicas de vistas materializadas
• Eliminar réplicas de vistas materializadas

Para obtener más información sobre las réplicas de vistas materializadas, consulta lo siguiente:

• Réplicas de vistas materializadas
• Crear réplicas de vistas materializadas

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. Los permisos necesarios para realizar una tarea (si los hay) se indican en la sección "Permisos necesarios" de la tarea.

Lista las réplicas de una vista materializada

Puedes enumerar las réplicas de vistas materializadas a través de la Google Cloud consola.

Permisos obligatorios

Para enumerar las réplicas de vistas materializadas de un conjunto de datos, necesitas el permiso de gestión de identidades y accesos bigquery.tables.list.

Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye los permisos que necesitas para enumerar las réplicas de vistas materializadas de un conjunto de datos:

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

Para obtener más información sobre los roles y permisos de gestión de identidades y accesos, consulta el artículo sobre roles y permisos predefinidos.

Para enumerar las réplicas de la vista materializada de un conjunto de datos, sigue estos pasos:

1. En el panel Explorador, expande tu proyecto y selecciona un conjunto de datos.

2. Desplázate por la lista para ver las tablas del conjunto de datos. Las tablas, las vistas y las vistas materializadas se identifican con iconos diferentes. Las réplicas de vistas materializadas tienen el mismo icono que las vistas materializadas.

   

Obtener información sobre las réplicas de vistas materializadas

Puede obtener información sobre una réplica de vista materializada mediante SQL, la herramienta de línea de comandos bq o la API de BigQuery.

Permisos obligatorios

Para consultar información sobre una réplica de una vista materializada, necesitas los siguientes permisos de gestión de identidades y accesos (IAM):

• bigquery.tables.get
• bigquery.tables.list
• bigquery.routines.get
• bigquery.routines.list

Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye los permisos anteriores:

• roles/bigquery.metadataViewer
• roles/bigquery.dataViewer
• roles/bigquery.admin

Para obtener más información sobre los permisos de BigQuery, consulta Control de acceso con gestión de identidades y accesos.

Para obtener información sobre una réplica de una vista materializada, incluida la vista materializada de origen, sigue estos pasos:

SQL

Para obtener información sobre las réplicas de vistas materializadas, consulta la vista INFORMATION_SCHEMA.TABLES:

1. En la Google Cloud consola, ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, introduce la siguiente instrucción:

   SELECT * FROM PROJECT_ID.DATASET_ID.INFORMATION_SCHEMA.TABLES
   WHERE table_type = 'MATERIALIZED VIEW';

   Haz los cambios siguientes:

   • PROJECT_ID: el nombre del proyecto que contiene las réplicas de la vista materializada
   • DATASET_ID: el nombre del conjunto de datos que contiene las réplicas de la vista materializada

3. 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:

bq show --project=project_id --format=prettyjson dataset.materialized_view_replica

Haz los cambios siguientes:

• project_id: el ID del proyecto. Solo tienes que incluir esta marca para obtener información sobre una réplica de una vista materializada en un proyecto distinto del predeterminado.
• dataset: el nombre del conjunto de datos que contiene la réplica de la vista materializada.
• materialized_view_replica: el nombre de la réplica de la vista materializada de la que quieres obtener información.

Ejemplo:

Introduce el siguiente comando para mostrar información sobre la réplica de la vista materializada my_mv_replica del conjunto de datos report_views del proyecto myproject.

bq show --project=myproject --format=prettyjson report_views.my_mv_replica

API

Para obtener información sobre las réplicas de vistas materializadas mediante la API, llama al método tables.get.

Eliminar réplicas de vistas materializadas

Puedes eliminar una réplica de vista materializada a través de la consola Google Cloud .

Precaución: No se puede deshacer la eliminación de una réplica de una vista materializada.

Permisos obligatorios

Para eliminar réplicas de vistas materializadas, necesita el permiso de gestión de identidades y accesos bigquery.tables.delete.

Cada uno de los siguientes roles de gestión de identidades y accesos predefinidos incluye los permisos que necesitas para eliminar una réplica de vista materializada:

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

Para obtener más información sobre la gestión de identidades y accesos (IAM) de BigQuery, consulta el artículo sobre roles y permisos predefinidos.

1. En el panel Explorador, despliega tu proyecto y selecciona la réplica de la vista materializada.

2. Abre la opción Acciones y haz clic en Eliminar.

3. En el cuadro de diálogo ¿Eliminar vista materializada?, escribe delete en el campo y, a continuación, haz clic en Eliminar.