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 di BigQuery include le seguenti operazioni:

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

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

• Repliche della vista materializzata
• Creare repliche della vista materializzata

Prima di iniziare

Concedi i ruoli IAM (Identity and Access Management) che forniscono agli utenti le autorizzazioni necessarie per eseguire ogni attività descritta 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 delle 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.

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

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

1. Nel riquadro a sinistra, fai clic su Explorer:

   

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

2. Nel riquadro Explorer, espandi il progetto, fai clic su Set di dati e poi 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.

Ottenere informazioni sulle repliche delle vista materializzata

Puoi ottenere informazioni su una replica della 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 IAM (Identity and Access Management):

• 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 ulteriori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.

Per ottenere informazioni su una replica della 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 della vista materializzata
   • DATASET_ID: il nome del set di dati che contiene le repliche della vista materializzata

3. Fai clic su Esegui.

Per saperne di più su come eseguire le 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 della 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 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 delle vista materializzata utilizzando l'API, chiama il metodo tables.get.

Elimina le repliche della 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 della vista materializzata, devi disporre dell'autorizzazione IAM bigquery.tables.delete.

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

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

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

1. Nel riquadro a sinistra, fai clic su Explorer:

   

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

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

4. Fai clic su Elimina.

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