Gestisci le repliche delle vista materializzata

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

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

• Elenca le vista materializzata materializzate
• Ottieni informazioni sulle vista materializzata materializzate
• Elimina le vista materializzata materializzate

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

• Repliche delle viste materializzate
• Crea vista materializzata materializzate

Prima di iniziare

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

Elenca le repliche delle vista materializzata

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

Autorizzazioni obbligatorie

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

Ognuno 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, consulta Ruoli e autorizzazioni predefiniti.

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

1. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

   Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro sinistro per aprirlo.

2. Nel riquadro Explorer, espandi il progetto, fai clic su Set di dati, quindi sul set di dati.

3. Fai clic su Panoramica > Tabelle. Scorri l'elenco per visualizzare le tabelle nel set di dati. Tabelle, viste e viste materializzate sono identificate da valori diversi nella colonna Tipo. Le repliche delle viste materializzate hanno lo stesso valore delle viste materializzate.

Ottieni informazioni sulle repliche delle vista materializzata

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 relative a una replica di una vista materializzata, devi disporre delle seguenti autorizzazioni di Identity and Access Management (IAM):

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

Ognuno dei seguenti ruoli IAM predefiniti include le autorizzazioni precedenti:

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

Per saperne di più sulle autorizzazioni di 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 ottenere 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 delle vista materializzata

3. Fai clic su Esegui.

Per saperne di più su come eseguire le query, consulta Esegui 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 seguente comando 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 sulla replica della vista materializzata utilizzando l'API, chiama il metodo tables.get.

Elimina le repliche delle vista materializzata

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

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

Autorizzazioni obbligatorie

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

Ognuno 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 predefiniti e autorizzazioni.

1. Nel riquadro a sinistra, fai clic su Spazio di esplorazione:

   

2. Nel riquadro Explorer, espandi il progetto, fai clic su Set di dati, quindi sul set di dati.

3. Fai clic su Panoramica > Tabelle, quindi sulla replica della vista materializzata.

4. Nel riquadro dei dettagli, fai clic su Altro > Elimina.

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