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.

  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

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

  1. Apri l'elenco delle istanze Bigtable nella Google Cloud console.

    Apri l'elenco delle istanze

  2. Seleziona un'istanza.

  3. Nel riquadro di navigazione, fai clic su Bigtable Studio.

  4. Apri una nuova scheda facendo clic su e poi scegliendo Editor.

    1. Quando viene visualizzato l'editor delle query, scrivi la query. Se la query è SQL valida, viene visualizzato il messaggio Valida.

    2. (Facoltativo) Per formattare l'istruzione in stile SQL, fai clic su Formato.

    3. Fai clic su Esegui. I risultati della query vengono visualizzati nella tabella Risultati.

    4. 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 aggiornare
  • INSTANCE: l'identificatore dell'istanza contenente la vista materializzata continua
  • DELETION_PROTECTION: true o false

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 eliminare
  • INSTANCE: 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

  1. Apri l'elenco delle istanze Bigtable nella Google Cloud console.

    Apri l'elenco delle istanze

  2. Seleziona un'istanza dall'elenco.

  3. Nel riquadro di navigazione, fai clic su Bigtable Studio. Viene visualizzato un elenco di viste materializzate continue.

  4. (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.

Passaggi successivi