Gerenciar réplicas de visualização materializadas

Neste documento, descrevemos como gerenciar réplicas de visualização materializadas no BigQuery.

O gerenciamento do BigQuery de réplicas de visualização materializadas inclui as seguintes operações:

Para mais informações sobre réplicas de visualização materializadas, consulte o seguinte:

Antes de começar

Atribua papéis do Identity and Access Management (IAM) que concedam aos usuários as permissões necessárias para realizar cada tarefa deste documento. As permissões necessárias para executar uma tarefa (se houver) são listadas na seção "Permissões necessárias".

Listar réplicas de visualização materializadas

É possível listar as réplicas de visualização materializadas no console do Google Cloud.

Permissões necessárias

Para listar as réplicas de visualização materializadas em um conjunto de dados, você precisa da permissão bigquery.tables.list do IAM.

Cada um dos papéis predefinidos do IAM a seguir inclui as permissões necessárias para listar as réplicas das visualizações materializadas em um conjunto de dados:

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

Para mais informações sobre os papéis e as permissões do IAM no IAM, consulte Papéis e permissões predefinidos.

Para listar as réplicas de visualização materializadas em um conjunto de dados:

  1. No painel Explorer, expanda o projeto e selecione um conjunto de dados.

  2. Percorra a lista para ver as tabelas no conjunto de dados. Tabelas, visualizações e visualizações materializadas são identificadas por ícones diferentes. As réplicas de visualização materializada têm o mesmo ícone das visualizações materializadas.

    Ícones de visualização e tabela

Receber informações sobre réplicas de visualização materializadas

É possível conseguir informações sobre uma réplica de visualização materializada usando o SQL, a ferramenta de linha de comando bq ou a API BigQuery.

Permissões necessárias

Para consultar informações sobre uma réplica de visualização materializada, você precisa das seguintes permissões de gerenciamento de identidade e acesso (IAM):

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

Cada um dos seguintes papéis predefinidos do IAM inclui as permissões anteriores:

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

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Para receber informações sobre uma réplica de visualização materializada, incluindo a visualização materializada de origem:

SQL

Para informações sobre réplicas de visualização materializadas, consulte a visualização INFORMATION_SCHEMA.TABLES:

  1. No Console do Google Cloud, acesse a página BigQuery.

    Ir para o BigQuery

  2. No editor de consultas, digite a seguinte instrução:

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

    Substitua:

    • PROJECT_ID: o nome do projeto que contém as réplicas de visualização materializadas.
    • DATASET_ID: o nome do conjunto de dados que contém as réplicas de visualização materializadas

  3. Clique em Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

bq

Use o comando bq show (em inglês).

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

Substitua:

  • project_id: o ID do projeto; Você só precisa incluir essa flag para receber informações sobre uma réplica de visualização materializada em um projeto diferente do padrão.
  • dataset: o nome do conjunto de dados que contém a réplica de visualização materializada.
  • materialized_view_replica: o nome da réplica de visualização materializada sobre a qual você quer informações.

Exemplo:

Insira o comando a seguir para mostrar informações sobre a réplica de visualização materializada my_mv_replica no conjunto de dados report_views no projeto myproject.

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

API

Para receber informações da réplica de visualização materializada usando a API, chame o método tables.get.

Excluir réplicas de visualização materializada

É possível excluir uma réplica de visualização materializada usando o console do Google Cloud.

Permissões necessárias

Para excluir as réplicas de visualização materializadas, você precisa da permissão bigquery.tables.delete do IAM.

Cada um dos papéis predefinidos do IAM a seguir inclui as permissões necessárias para excluir uma réplica de visualização materializada:

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

Para mais informações sobre o BigQuery Identity and Access Management (IAM), consulte Papéis e permissões predefinidos.

  1. No painel Explorer, expanda seu projeto e selecione a réplica de visualização materializada.

  2. Expanda a opção Ações e clique em Excluir.

  3. Na caixa de diálogo Excluir visualização materializada?, digite delete no campo e clique em Excluir.