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.
-
Install the Google Cloud CLI.
-
Se estiver a usar um fornecedor de identidade (IdP) externo, tem primeiro de iniciar sessão na CLI gcloud com a sua identidade federada.
-
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
Abra a lista de instâncias do Bigtable na Google Cloud consola.
Selecione uma instância.
No painel de navegação, clique em Bigtable Studio.
Abra um novo separador clicando em
e, de seguida, escolhendo Editor.Quando o editor de consultas aparecer, escreva a sua consulta. Se a consulta for SQL válida, é apresentada a mensagem Válido.
Opcional: para formatar a declaração no estilo SQL, clique em Formatar.
Clique em Executar. Os resultados da consulta aparecem na tabela Resultados.
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 atualizarINSTANCE
: o identificador da instância que contém a vista materializada contínuaDELETION_PROTECTION
:true
oufalse
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
Abra a lista de instâncias do Bigtable na Google Cloud consola.
Selecione uma instância na lista.
No painel de navegação, clique em Bigtable Studio.
Expanda Vistas materializadas.
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 eliminarINSTANCE
: 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
Abra a lista de instâncias do Bigtable na Google Cloud consola.
Selecione uma instância na lista.
No painel de navegação, clique em Bigtable Studio. É apresentada uma lista de vistas materializadas contínuas.
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.