Criar e gerenciar visualizações materializadas contínuas

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

É possível criar uma visualização materializada contínua usando a CLI do Google Cloud, o editor de consulta do Bigtable Studio no console do Google Cloud 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. Install the Google Cloud CLI.

  2. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  3. To initialize the gcloud CLI, run the following command: 

    gcloud init

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, solicite 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
  • Lista: 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 e verifique se eles podem ser dimensionados se necessário enquanto o Bigtable processa e sincroniza a visualização materializada contínua e processa qualquer uso de armazenamento adicional.
  • Identifique uma tabela do Bigtable que você tem permissão para ler e use como fonte da visualização materializada contínua.
  • Prepare a consulta SQL que define a visualização materializada contínua. Para requisitos de consulta, consulte Consultas de visualização materializada contínua.

Depois de criar uma visualização materializada contínua, pode levar alguns minutos para que ela fique ativa e possa ser consultada. É possível conferir as métricas da visualização para monitorar o progresso.

Console

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

    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 em seguida em Editor.

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

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

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

    4. Quando estiver satisfeito com a consulta, clique em Salvar e escolha Visualização materializada.

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

gcloud

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

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

Substitua:

  • VIEW: um identificador exclusivo para a 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 para a 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 suas 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 beta bigtable materialized-views update command.

gcloud beta 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.

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

gcloud beta 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

Você pode conferir uma lista de visualizações materializadas contínuas para uma instância.

Console

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

    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 é exibida.

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

gcloud

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

gcloud bigtable materialized-views list --instance=INSTANCE

Substitua INSTANCE pelo ID da instância.

A seguir