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, confira 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 console 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, 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
  • 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. Assim, eles poderão ser escalonar verticalmente, se necessário, enquanto o Bigtable processa e sincroniza a visualização materializada contínua e lida com qualquer uso de 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.

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

Console

  1. Abra a lista de instâncias do Bigtable no console 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 escolhendo Editor.

    1. Quando o editor de consultas aparecer, crie sua consulta. Se a consulta for SQL válida, uma mensagem Válida 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 tudo certo 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 com 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 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, adicione o seguinte ao comando:

--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 em uma visualização materializada contínua, use o comando 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.

Console

  1. Abra a lista de instâncias do Bigtable no console 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.

  4. Expanda Visualizações materializadas.

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

gcloud

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

É 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 console 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