Creare e gestire 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 Viste materializzate continue.

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 gcloud CLI, segui questi passaggi.

1. Installa Google Cloud CLI.

   Nota: se hai già installato gcloud CLI, assicurati di avere l'ultima versione eseguendo gcloud components update.

2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

3. Per inizializzare gcloud CLI, esegui questo comando:

   gcloud init

   Nota: puoi eseguire gcloud CLI nella console senza installare Google Cloud CLI. Google Cloud Per eseguire la gcloud CLI nella Google Cloud console, utilizza Cloud Shell.

Nota: se gcloud CLI restituisce un messaggio Method not found, esegui di nuovo il comando gcloud auth login.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare e gestire viste materializzate continue, chiedi all'amministratore di concederti il ruolo Bigtable Admin (roles/bigtable.admin) sull'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
• Elenca: bigtable.materializedViews.list

Per creare una vista materializzata continua, devi disporre anche almeno dell'autorizzazione bigtable.tables.readRows sulla 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:

• (Facoltativo) Come best practice, attiva la scalabilità automatica per i cluster nell'istanza per assicurarti che possano essere scalati orizzontalmente, se necessario, mentre Bigtable elabora e sincronizza la vista materializzata continua e per gestire qualsiasi utilizzo di spazio di archiviazione aggiuntivo.
• Identifica una tabella Bigtable per cui hai l'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 delle vista materializzata continue queries.

Dopo aver creato una vista materializzata continua, Bigtable completa il riempimento iniziale. La vista diventa attiva e su cui è possibile eseguire query solo al termine di questo processo. Puoi esaminare le metriche della vista per monitorare l'avanzamento. Per scoprire come eseguire query sulla vista prima del completamento del riempimento iniziale, consulta Leggere i dati durante il riempimento iniziale.

Console

Nota: per creare viste materializzate continue che utilizzano funzioni non deterministiche, utilizza gcloud CLI.

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 di query, scrivi la query. Se la query è SQL valido, viene visualizzato un messaggio Valido.

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

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

   4. Quando la query ti soddisfa, fai clic sulla freccia di espansione Salva con nome e scegli Salva come vista materializzata.

5. Nella finestra di dialogo Salva la vista materializzata , inserisci un nome per la vista e fai clic su Salva.

   Per saperne di più sull'utilizzo dell'editor di query, consulta Gestire i dati utilizzando Bigtable Studio.

gcloud

Per creare una vista materializzata continua, utilizza il gcloud bigtable materialized-views create comando:

    gcloud 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 in. Deve essere la stessa istanza della tabella di origine.
• QUERY: un'istruzione SQL valida che definisce la vista materializzata continua.

Il comando accetta i seguenti flag facoltativi:

• Per attivare la protezione da eliminazione per la vista materializzata continua, aggiungi il comando con --deletion-protection=DELETION_PROTECTION. Sostituisci DELETION_PROTECTION con true o false.
• Se la query SQL utilizza funzioni non deterministiche, aggiungi il comando con il --ignore-warnings flag. Questo flag garantisce che tu riconosca che queste funzioni potrebbero far sì che cluster diversi producano risultati diversi per la stessa vista. Se ometti il flag, la convalida della query non riesce.

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 il gcloud bigtable materialized-views update comando.

gcloud bigtable materialized-views update VIEW \
        --instance=INSTANCE --deletion-protection=DELETION_PROTECTION

Sostituisci quanto segue:

• VIEW: l'identificatore univoco della 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 cui non è attivata la protezione da eliminazione. Non puoi annullare questa operazione.

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.

4. Espandi Viste materializzate.

5. Accanto alla vista che vuoi eliminare, fai clic sul more_vert, e poi su Elimina.

gcloud

Per eliminare una vista materializzata continua, utilizza il gcloud bigtable materialized-views delete comando:

gcloud 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

Ottenere un elenco di viste materializzate continue

Puoi visualizzare un elenco di viste 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 viste nell'istanza. Per visualizzarne altre 10, fai clic su Mostra altro.

gcloud

Per elencare tutte le viste materializzate continue per un'istanza, utilizza il gcloud bigtable materialized-views list comando.

gcloud bigtable materialized-views list --instance=INSTANCE

Sostituisci INSTANCE con l'ID istanza.

Passaggi successivi

• Query vista materializzata continue
• Tabelle e visualizzazioni