Crie e faça a gestão de vistas materializadas contínuas

Este documento descreve como criar e realizar operações numa vista materializada contínua no Bigtable. Antes de ler este documento, leia a vista geral em Vistas materializadas contínuas.

Pode criar uma vista materializada contínua através da Google Cloud CLI, do editor de consultas do Bigtable Studio na consola Google Cloud ou das bibliotecas de cliente do Bigtable para Java e Go.

Antes de começar

Siga os passos seguintes se planear usar a CLI gcloud.

  1. Install the Google Cloud CLI.

  2. Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.

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

    gcloud init

Funções necessárias

Para receber as autorizações necessárias para criar e gerir vistas materializadas contínuas, peça ao seu administrador para lhe conceder a função de administrador do Bigtable (roles/bigtable.admin) na instância. Caso contrário, peça as seguintes autorizações ao nível da instância, consoante a operação que quer realizar:

  • Criado: bigtable.materializedViews.create
  • Atualização: bigtable.materializedViews.update
  • Eliminar: bigtable.materializedViews.delete
  • Lista: bigtable.materializedViews.list

Para criar uma vista materializada contínua, também tem de ter, pelo menos, a autorização bigtable.tables.readRows na tabela de origem.

Para ver todas as funções e autorizações disponíveis, consulte o artigo Controlo de acesso do Bigtable com a IAM.

Crie uma vista materializada contínua

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

  • Opcional: como prática recomendada, ative o dimensionamento automático para clusters na sua instância para se certificar de que podem ser dimensionados, se necessário, enquanto o Bigtable processa e sincroniza a vista materializada contínua e para processar qualquer utilização de armazenamento adicional.
  • Identifique uma tabela do Bigtable para a qual tenha autorização de leitura para usar como origem da vista materializada contínua.
  • Prepare a consulta SQL que define a sua vista materializada contínua. Para ver os requisitos de consulta, consulte o artigo Consultas de vistas materializadas contínuas.

Depois de criar uma vista materializada contínua, pode demorar alguns minutos a ficar ativa e consultável. Pode consultar as métricas da vista para monitorizar o respetivo progresso.

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Selecione uma instância.

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

  4. Abra um novo separador clicando em e, de seguida, escolhendo Editor.

    1. Quando o editor de consultas aparecer, escreva a sua consulta. Se a consulta for SQL válida, é apresentada a mensagem Válido.

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

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

    4. Quando estiver tudo pronto, clique em Guardar e, de seguida, escolha Vista materializada.

    Para mais informações sobre a utilização do editor de consultas, consulte o artigo Faça a gestão dos seus dados com o Bigtable Studio.

gcloud

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

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

Substitua o seguinte:

  • VIEW: um identificador exclusivo para a vista materializada contínua. Usa este ID como o ID da tabela quando consulta a visualização materializada contínua.
  • INSTANCE: o identificador da instância na qual criar a vista materializada contínua. Tem de ser a mesma instância que a tabela de origem.
  • QUERY: uma declaração SQL válida que define a vista materializada contínua.

Opcional: para ativar a proteção contra eliminação para a vista materializada contínua, acrescente o comando com o seguinte:

--deletion-protection=DELETION_PROTECTION

Substitua DELETION_PROTECTION por true ou false.

Atualize uma vista materializada contínua

Pode atualizar a proteção contra eliminação de uma vista materializada contínua. Não pode atualizar a consulta SQL que define uma vista materializada contínua. Se precisar de modificar a consulta, tem de eliminar a vista materializada contínua e, em seguida, criar uma nova que inclua as suas alterações.

Consola

Não pode atualizar uma vista materializada contínua na consola. Em alternativa, use a CLI gcloud.

gcloud

Para ativar ou desativar a proteção contra eliminação para uma vista 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 o seguinte:

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

Elimine uma vista materializada contínua

Pode eliminar uma vista materializada contínua que não tenha a proteção contra eliminação ativada. Não é possível anular esta operação.

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Selecione uma instância na lista.

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

  4. Expanda Vistas materializadas.

  5. Junto à vista que quer eliminar, clique no menu de ações more_vert e, de seguida, clique em Eliminar.

gcloud

Para eliminar uma vista materializada contínua, use o comando gcloud beta bigtable materialized-views delete:

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

Substitua o seguinte:

  • VIEW: o identificador exclusivo da vista materializada contínua que quer eliminar
  • INSTANCE: o identificador da instância que contém a vista materializada contínua

Aceda a uma lista de vistas materializadas contínuas

Pode ver uma lista de vistas materializadas contínuas para uma instância.

Consola

  1. Abra a lista de instâncias do Bigtable na Google Cloud consola.

    Abra a lista de instâncias

  2. Selecione uma instância na lista.

  3. No painel de navegação, clique em Bigtable Studio. É apresentada uma lista de vistas materializadas contínuas.

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

gcloud

Para apresentar uma lista de todas as vistas 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.

O que se segue?