Criar e gerenciar visualizações materializadas contínuas

Este documento descreve como criar e realizar operações em uma visualização materializada contínua no Bigtable. Antes de ler este documento, consulte a visão geral em Visualizações materializadas contínuas.

É possível criar uma visualização materializada contínua usando a Google Cloud CLI, o editor de consultas do Bigtable Studio no Google Cloud console ou as bibliotecas de cliente do Bigtable para Java e Go.

Antes de começar

Siga estas etapas se você planeja usar a CLI gcloud.

1. Instale a Google Cloud CLI.

   Observação: se você já tiver instalado a CLI gcloud, execute gcloud components update para verificar se você tem a versão mais recente.

2. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

3. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

   Observação: execute a CLI gcloud no Google Cloud console sem instalar a Google Cloud CLI. Para executar a CLI gcloud no Google Cloud console, use Cloud Shell.

Observação: se a CLI gcloud retornar uma mensagem Method not found, execute o comando gcloud auth login novamente.

Funções exigidas

Para receber as permissões necessárias para criar e gerenciar visualizações materializadas contínuas, peça ao administrador para conceder a você o papel de administrador do Bigtable (roles/bigtable.admin) na instância. Caso contrário, peça as seguintes permissões no nível da instância, dependendo da operação que você quer realizar:

• Criar: bigtable.materializedViews.create
• Atualizar: bigtable.materializedViews.update
• Excluir: bigtable.materializedViews.delete
• Listar: bigtable.materializedViews.list

Para criar uma visualização materializada contínua, você também precisa ter pelo menos a permissão bigtable.tables.readRows na tabela de origem.

Para conferir todos os papéis e permissões disponíveis, consulte Controle de acesso do Bigtable com o IAM.

Criar uma visualização materializada contínua

Antes de criar uma visualização materializada contínua, faça o seguinte:

• Opcional: como prática recomendada, ative o escalonamento automático para clusters na sua instância para garantir que eles possam ser escalonar verticalmente, se necessário, enquanto o Bigtable processa e sincroniza a visualização materializada contínua e para lidar com qualquer uso do armazenamento adicional.
• Identifique uma tabela do Bigtable que você tenha permissão para ler e usar como origem da visualização materializada contínua.
• Prepare a consulta SQL que define sua visualização materializada contínua. Para requisitos de consulta, consulte Consultas de visualização materializada contínua consultas.

Depois de criar uma visualização materializada contínua, ela pode levar alguns minutos para ficar ativa e pronta para consultas. É possível consultar as métricas da visualização para monitorar o progresso.

Console

1. Abra a lista de instâncias do Bigtable no Google Cloud console.

   Abrir a lista de instâncias

2. Selecione uma instância.

3. No painel de navegação, clique em Bigtable Studio.

4. Abra uma nova guia clicando em e escolhendo Editor.

   1. Quando o editor de consultas aparecer, crie sua consulta. Se a consulta for um SQL válido, uma mensagem Válido será exibida.

   2. Opcional: para formatar sua instrução no estilo SQL, clique em Formatar.

   3. Clique em Executar. Os resultados da consulta aparecem na tabela Resultados.

   4. Quando estiver satisfeito com a consulta, clique na seta do expansor Salvar como e escolha Salvar como visualização materializada.

5. Na caixa de diálogo Salvar sua visualização materializada , insira um nome para a visualização e clique em Salvar.

   Para mais informações sobre como usar o editor de consultas, consulte Gerenciar dados usando o Bigtable Studio.

gcloud

Para criar uma visualização materializada contínua, use o gcloud bigtable materialized-views create comando:

    gcloud bigtable materialized-views create VIEW \
            --instance=INSTANCE --query=QUERY

Substitua:

• VIEW: um identificador exclusivo da visualização materializada contínua. Use esse ID como o ID da tabela ao consultar a visualização materializada contínua.
• INSTANCE: o identificador da instância em que a visualização materializada contínua será criada. Precisa ser a mesma instância da tabela de origem.
• QUERY: uma instrução SQL válida que define a visualização materializada contínua.

Opcional: para ativar a proteção contra exclusão da visualização materializada contínua, anexe o comando com o seguinte:

--deletion-protection=DELETION_PROTECTION

Substitua DELETION_PROTECTION por true ou false.

Atualizar uma visualização materializada contínua

É possível atualizar a proteção contra exclusão de uma visualização materializada contínua. Não é possível atualizar a consulta SQL que define uma visualização materializada contínua. Se você precisar modificar a consulta, exclua a visualização materializada contínua e crie uma nova que inclua as mudanças.

Console

Não é possível atualizar uma visualização materializada contínua no console. Em vez disso, use a CLI gcloud.

gcloud

Para ativar ou desativar a proteção contra exclusão de uma visualização materializada contínua, use o gcloud bigtable materialized-views update command comando.

gcloud bigtable materialized-views update VIEW \
        -–instance=INSTANCE --deletion-protection=DELETION_PROTECTION

Substitua:

• VIEW: o identificador exclusivo da visualização materializada contínua que você quer atualizar
• INSTANCE: o identificador da instância que contém a visualização materializada contínua
• DELETION_PROTECTION: true ou false

Excluir uma visualização materializada contínua

É possível excluir uma visualização materializada contínua que não tenha a proteção contra exclusão ativada. Não é possível desfazer essa operação.

Console

1. Abra a lista de instâncias do Bigtable no Google Cloud console.

   Abrir a lista de instâncias

2. Selecione uma instância na lista.

3. No painel de navegação, clique em Bigtable Studio.

4. Expanda Visualizações materializadas.

5. Ao lado da visualização que você quer excluir, clique no more_vert menu de ações, e em Excluir.

gcloud

Para excluir uma visualização materializada contínua, use o gcloud bigtable materialized-views delete comando:

gcloud bigtable materialized-views delete VIEW \
      --instance=INSTANCE

Substitua:

• VIEW: o identificador exclusivo da visualização materializada contínua que você quer excluir
• INSTANCE: o identificador da instância que contém a visualização materializada contínua

Receber uma lista de visualizações materializadas contínuas

É possível conferir uma lista de visualizações materializadas contínuas de uma instância.

Console

1. Abra a lista de instâncias do Bigtable no Google Cloud console.

   Abrir a lista de instâncias

2. Selecione uma instância na lista.

3. No painel de navegação, clique em Bigtable Studio. Uma lista de visualizações materializadas contínuas será exibida.

4. Opcional: as 10 primeiras visualizações na instância são listadas. Para conferir mais 10, clique em Mostrar mais.

gcloud

Para listar todas as visualizações materializadas contínuas de uma instância, use o gcloud bigtable materialized-views list comando.

gcloud bigtable materialized-views list --instance=INSTANCE

Substitua INSTANCE pelo ID da instância.

A seguir

• Consultas de visualização materializada contínua
• Tabelas e visualizações