Gestire le repliche delle viste materializzate

Questo documento descrive come gestire le repliche delle viste materializzate in BigQuery.

La gestione delle repliche delle viste materializzate da parte di BigQuery include le seguenti operazioni:

Per ulteriori informazioni sulle repliche delle visualizzazioni materializzate, consulta quanto segue:

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 richieste per eseguire un'attività (se presenti) sono elencate nella sezione "Autorizzazioni richieste" dell'attività.

Elenca le repliche delle viste materializzate

Puoi elencare le repliche delle viste edificate tramite la console Google Cloud.

Autorizzazioni obbligatorie

Per elencare le repliche delle visualizzazioni materializzate 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 visualizzazioni materializzate 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 viste materializzate 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.

    Icone di tabelle e visualizzazioni

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 viste materializzate, 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 delle viste materializzate
    • DATASET_ID: il nome del set di dati che contiene le repliche delle viste materializzate

  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 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 delle visualizzazioni materializzate utilizzando l'API, chiama il metodo tables.get.

Elimina le repliche delle viste materializzate

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

Autorizzazioni obbligatorie

Per eliminare le repliche delle viste materializzate, 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.