Crea e gestisci viste materializzate continue
Questo documento descrive come creare ed eseguire operazioni su una vista materializzata continua in Bigtable. Prima di leggere questo documento, consulta la panoramica in Visualizzazioni con dati materializzati continui.
Puoi creare una vista materializzata continua utilizzando Google Cloud CLI, l'editor di query di Bigtable Studio nella Google Cloud console o le librerie client Bigtable per Java e Go.
Prima di iniziare
Se prevedi di utilizzare l'interfaccia a riga di comando gcloud, segui questi passaggi.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per creare e gestire le viste materializzate continue, chiedi all'amministratore di concederti il ruolo Amministratore Bigtable (roles/bigtable.admin
) nell'istanza.
In caso contrario, richiedi le seguenti autorizzazioni a livello di istanza, a seconda dell'operazione che vuoi eseguire:
- Crea:
bigtable.materializedViews.create
- Aggiorna:
bigtable.materializedViews.update
- Elimina:
bigtable.materializedViews.delete
- Elenco:
bigtable.materializedViews.list
Per creare una vista materializzata continua, devi disporre anche dell'autorizzazione minimabigtable.tables.readRows
per la tabella di origine.
Per visualizzare tutti i ruoli e le autorizzazioni disponibili, consulta Controllo dell'accesso a Bigtable con IAM.
Creare una vista materializzata continua
Prima di creare una vista materializzata continua, svolgi i seguenti passaggi:
- (Facoltativo) Come best practice, attiva la scalabilità automatica per i cluster della tua istanza per assicurarti che possano aumentare di dimensioni, se necessario, mentre Bigtable elabora e sincronizza la vista materializzata continua e per gestire qualsiasi utilizzo aggiuntivo dello spazio di archiviazione.
- Identifica una tabella Bigtable per la quale disponi dell'autorizzazione di lettura da utilizzare come origine per la vista materializzata continua.
- Prepara la query SQL che definisce la vista materializzata continua. Per i requisiti delle query, consulta Query sulle viste materializzate continue.
Dopo aver creato una vista materializzata continua, potrebbero essere necessari alcuni minuti prima che diventi attiva e interrogabile. Puoi esaminare le metriche della visualizzazione per monitorarne l'avanzamento.
Console
Apri l'elenco delle istanze Bigtable nella Google Cloud console.
Seleziona un'istanza.
Nel riquadro di navigazione, fai clic su Bigtable Studio.
Apri una nuova scheda facendo clic su
e poi scegliendo Editor.Quando viene visualizzato l'editor delle query, scrivi la query. Se la query è SQL valida, viene visualizzato il messaggio Valida.
(Facoltativo) Per formattare l'istruzione in stile SQL, fai clic su Formato.
Fai clic su Esegui. I risultati della query vengono visualizzati nella tabella Risultati.
Quando la query ti soddisfa, fai clic su Salva e poi scegli Vista con dati memorizzati in memoria.
Per ulteriori informazioni sull'utilizzo dell'editor di query, consulta Gestire i dati utilizzando Bigtable Studio.
gcloud
Per creare una vista materializzata continua, utilizza il comando
gcloud beta bigtable materialized-views create
:
gcloud beta bigtable materialized-views create VIEW \
--instance=INSTANCE --query=QUERY
Sostituisci quanto segue:
VIEW
: un identificatore univoco per la vista materializzata continua. Utilizza questo ID come ID tabella quando esegui query sulla vista materializzata continua.INSTANCE
: l'identificatore dell'istanza in cui creare la vista materializzata continua. Deve essere la stessa istanza della tabella di origine.QUERY
: un'istruzione SQL valida che definisce la vista materializzata continua.
(Facoltativo) Per attivare la protezione da eliminazione per la vista materializzata continua, aggiungi al comando quanto segue:
--deletion-protection=DELETION_PROTECTION
Sostituisci DELETION_PROTECTION
con true
o
false
.
Aggiornare una vista materializzata continua
Puoi aggiornare la protezione da eliminazione per una vista materializzata continua. Non puoi aggiornare la query SQL che definisce una vista materializzata continua. Se devi modificare la query, devi eliminare la vista materializzata continua e poi crearne una nuova che includa le modifiche.
Console
Non puoi aggiornare una vista materializzata continua nella console. Utilizza invece gcloud CLI.
gcloud
Per attivare o disattivare la protezione da eliminazione per una vista materializzata continua, utilizza
gcloud beta bigtable materialized-views update command
.
gcloud beta bigtable materialized-views update VIEW \
-–instance=INSTANCE --deletion-protection=DELETION_PROTECTION
Sostituisci quanto segue:
VIEW
: l'identificatore univoco per la vista materializzata continua che vuoi aggiornareINSTANCE
: l'identificatore dell'istanza contenente la vista materializzata continuaDELETION_PROTECTION
:true
ofalse
Eliminare una vista materializzata continua
Puoi eliminare una vista materializzata continua per la quale non è attivata la protezione dall'eliminazione. Questa operazione non può essere annullata.
Per eliminare una vista materializzata continua, utilizza il comando gcloud beta bigtable
materialized-views delete
:
gcloud beta bigtable materialized-views delete VIEW \
--instance=INSTANCE
Sostituisci quanto segue:
VIEW
: l'identificatore univoco della vista materializzata continua che vuoi eliminareINSTANCE
: l'identificatore dell'istanza contenente la vista materializzata continua
Visualizzare un elenco di viste materializzate continue
Puoi visualizzare un elenco di visualizzazioni materializzate continue per un'istanza.
Console
Apri l'elenco delle istanze Bigtable nella Google Cloud console.
Seleziona un'istanza dall'elenco.
Nel riquadro di navigazione, fai clic su Bigtable Studio. Viene visualizzato un elenco di viste materializzate continue.
(Facoltativo) Vengono elencate le prime 10 visualizzazioni nell'istanza. Per visualizzarne altri 10, fai clic su Mostra altro.
gcloud
Per elencare tutte le viste materializzate continue per un'istanza, utilizza il comando gcloud bigtable
materialized-views list
.
gcloud bigtable materialized-views list --instance=INSTANCE
Sostituisci INSTANCE
con l'ID istanza.