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:
- Listar réplicas de visualização materializadas
- Receber informações sobre réplicas de visualização materializadas
- Excluir réplicas de visualização materializada
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:
No painel Explorer, expanda o projeto e selecione um conjunto de dados.
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.
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
:
No Console do Google Cloud, acesse a página BigQuery.
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
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.
No painel Explorer, expanda seu projeto e selecione a réplica de visualização materializada.
Expanda a opção
Ações e clique em Excluir.Na caixa de diálogo Excluir visualização materializada?, digite
delete
no campo e clique em Excluir.