Gestire le repliche delle vista materializzata

Questo documento descrive come gestire le repliche delle vista materializzata in BigQuery.

La gestione delle repliche delle vista materializzata da parte di BigQuery include le seguenti operazioni:

• Elenca le vista materializzata materializzate
• Ottenere informazioni sulle vista materializzata materializzate
• Eliminare le vista materializzata materializzate

Per ulteriori informazioni sulle repliche vista materializzata, consulta quanto segue:

• Riproduzione delle viste materializzate
• Creare vista materializzata materializzate

Prima di iniziare

Concedi i ruoli IAM (Identity and Access Management) che concedono agli utenti le autorizzazioni necessarie per eseguire ogni attività in questo documento. Le autorizzazioni richieste per eseguire un'attività (se presenti) sono elencate nella sezione "Autorizzazioni richieste" dell'attività.

Elenca le repliche delle vista materializzata

Puoi elencare le repliche vista materializzata tramite la console Google Cloud.

Autorizzazioni obbligatorie

Per elencare le repliche vista materializzata in un set di dati, devi disporre dell'autorizzazione IAM bigquery.tables.list.

Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per elencare le repliche delle vista materializzata in un set di dati:

• roles/bigquery.user
• roles/bigquery.metadataViewer
• roles/bigquery.dataViewer
• roles/bigquery.dataOwner
• roles/bigquery.dataEditor
• roles/bigquery.admin

Per saperne di più sui ruoli e sulle autorizzazioni IAM in IAM, consulta Ruoli e autorizzazioni predefiniti.

Per elencare le repliche delle vista materializzata in un set di dati:

1. Nel riquadro Spazio di esplorazione, espandi il progetto e seleziona un set di dati.

2. Scorri l'elenco per visualizzare le tabelle nel set di dati. Le tabelle, le visualizzazioni e le visualizzazioni materializzate sono identificate da icone diverse. Le repliche delle viste materializzate hanno la stessa icona delle viste materializzate.

   

Visualizzare informazioni sulle repliche delle viste materializzate

Puoi ottenere informazioni su una replica di una vista materializzata utilizzando SQL, lo strumento a riga di comando bq o l'API BigQuery.

Autorizzazioni obbligatorie

Per eseguire query sulle informazioni di una replica di una vista materializzata, devi disporre delle seguenti autorizzazioni IAM:

• bigquery.tables.get
• bigquery.tables.list
• bigquery.routines.get
• bigquery.routines.list

Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni precedenti:

• roles/bigquery.metadataViewer
• roles/bigquery.dataViewer
• roles/bigquery.admin

Per ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Per ottenere informazioni su una replica di una vista materializzata, inclusa la vista materializzata di origine:

SQL

Per informazioni sulle repliche delle vista materializzata, esegui una query sulla vista INFORMATION_SCHEMA.TABLES:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nell'editor di query, inserisci la seguente istruzione:

   SELECT * FROM PROJECT_ID.DATASET_ID.INFORMATION_SCHEMA.TABLES
   WHERE table_type = 'MATERIALIZED VIEW';

   Sostituisci quanto segue:

   • PROJECT_ID: il nome del progetto che contiene le repliche vista materializzata
   • DATASET_ID: il nome del set di dati che contiene le repliche vista materializzata

3. Fai clic su Esegui.

Per ulteriori informazioni su come eseguire query, consulta Eseguire una query interattiva.

bq

Utilizza il comando bq show:

bq show --project=project_id --format=prettyjson dataset.materialized_view_replica

Sostituisci quanto segue:

• project_id: l'ID progetto. Devi includere questo flag solo per ottenere informazioni su una replica di una vista materializzata in un progetto diverso da quello predefinito.
• dataset: il nome del set di dati che contiene la replica della vista materializzata.
• materialized_view_replica: il nome della replica della vista materializzata di cui vuoi informazioni.

Esempio:

Inserisci il comando seguente per visualizzare le informazioni sulla replica della vista materializzata my_mv_replica nel set di dati report_views nel progetto myproject.

bq show --project=myproject --format=prettyjson report_views.my_mv_replica

API

Per ottenere informazioni sulle repliche vista materializzata utilizzando l'API, chiama il metodo tables.get.

Elimina le repliche delle vista materializzata

Puoi eliminare una replica di una vista materializzata tramite la console Google Cloud.

Attenzione: l'eliminazione di una replica di una vista materializzata non può essere annullata.

Autorizzazioni obbligatorie

Per eliminare le repliche vista materializzata, devi disporre dell'autorizzazione IAM bigquery.tables.delete.

Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per eliminare una replica di una vista materializzata:

• bigquery.dataEditor
• bigquery.dataOwner
• bigquery.admin

Per saperne di più su Identity and Access Management (IAM) di BigQuery, consulta Ruoli e autorizzazioni predefiniti.

1. Nel riquadro Explorer, espandi il progetto e seleziona la replica della vista materializzata.

2. Espandi l'opzione Azioni e fai clic su Elimina.

3. Nella finestra di dialogo Vuoi eliminare la vista materializzata?, digita delete nel campo e fai clic su Elimina.