Administra réplicas de vistas materializadas

Este documento describe cómo crear réplicas de vista materializada en BigQuery.

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

• Enumera réplicas de vistas materializadas
• Obtén información sobre las réplicas de vistas materializadas
• Borra réplicas de vistas materializadas

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

• Réplicas de vista materializadas
• Crea réplicas de vista materializadas

Antes de comenzar

Otorga funciones de la Identity and Access Management (IAM) que les brindan a los usuarios los permisos necesarios para realizar cada tarea de este documento. Los permisos necesarios para realizar una tarea (si existen) se enumeran en la sección “Permisos necesarios” de la tarea.

Enumera réplicas de vistas materializadas

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

Permisos necesarios

Para mostrar las réplicas de vistas materializadas en un conjunto de datos, necesitas el permiso bigquery.tables.list de IAM.

Cada uno de los siguientes roles predefinidos de IAM incluye los permisos que necesitas para mostrar las réplicas de vistas materializadas en 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 los permisos de IAM, consulta Roles y permisos predefinidos.

Para enumerar las réplicas de vistas materializadas en un conjunto de datos, sigue estos pasos:

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

2. Desplázate por la lista para ver las tablas en el conjunto de datos. Las tablas, las vistas y las vistas materializadas se identifican a través de íconos diferentes. Las réplicas de vistas materializadas tienen el mismo ícono que las vistas materializadas.

   

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

Puedes obtener información sobre una réplica de vistas materializadas con SQL, la herramienta de línea de comandos de bq o la API de BigQuery.

Permisos necesarios

Para consultar información sobre una réplica de vistas materializadas, necesitas los siguientes permisos de Identity and Access Management (IAM):

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

Cada uno de los siguientes roles predefinidos de IAM incluye los permisos anteriores:

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

Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.

Para obtener información sobre una réplica de vistas materializadas, 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 consola de Google Cloud, ve a la página de BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el nombre del proyecto que contiene las réplicas de vistas materializadas
   • DATASET_ID: el nombre del conjunto de datos que contiene las réplicas de vistas materializadas

3. Haz clic en Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

Usa el comando bq show:

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

Reemplaza lo siguiente:

• project_id: El ID del proyecto. Solo debes incluir esta marca para obtener información sobre una réplica de vistas materializadas en un proyecto diferente del proyecto predeterminado.
• dataset: Es el nombre del conjunto de datos que contiene la réplica de la vista materializada.
• materialized_view_replica: Es el nombre de la réplica de vistas materializadas sobre la que deseas obtener información.

Ejemplo:

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

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

API

Para obtener información de la réplica de vista materializada con la API, llama al método tables.get.

Borra réplicas de vistas materializadas

Puedes borrar una réplica de vistas materializadas a través de la consola de Google Cloud.

Precaución: La eliminación de una réplica de vistas materializadas no se puede deshacer.

Permisos necesarios

Para borrar réplicas de vistas materializadaa, necesitas el permiso bigquery.tables.delete de IAM.

Cada uno de los siguientes roles predefinidos de IAM incluye los permisos que necesitas para borrar una réplica de vistas materializadas:

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

Para obtener más información sobre la Identity and Access Management (IAM) de BigQuery, consulta Roles y permisos predefinidos.

1. En el panel Explorador, expande tu proyecto y selecciona la réplica de vistas materializadas.

2. Expande la opción Acciones y haz clic en Borrar.

3. En el cuadro de diálogo ¿Quieres borrar la vista materializada?, escribe delete en el campo y, luego, haz clic en Borrar.