MATERIALIZED_VIEWS visualizzazione

La vista INFORMATION_SCHEMA.MATERIALIZED_VIEWS contiene lo stato delle viste materializzate.

Autorizzazioni obbligatorie

Per ottenere le autorizzazioni di cui hai bisogno per eseguire query sulla vista INFORMATION_SCHEMA.MATERIALIZED_VIEWS, chiedi all'amministratore di concederti Ruolo IAM Visualizzatore metadati BigQuery (roles/bigquery.metadataViewer) per il progetto o il set di dati. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per eseguire query sulla vista INFORMATION_SCHEMA.MATERIALIZED_VIEWS. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per eseguire query sulla vista INFORMATION_SCHEMA.MATERIALIZED_VIEWS sono necessarie le seguenti autorizzazioni:

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

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

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

Schema

Quando esegui una query sulla vista INFORMATION_SCHEMA.MATERIALIZED_VIEWS, i risultati della query contengono una riga per ogni vista materializzata in un set di dati.

La vista INFORMATION_SCHEMA.MATERIALIZED_VIEWS ha il seguente schema:

Nome colonna Tipo di dati Valore
TABLE_CATALOG STRING Il nome del progetto che contiene il set di dati. Chiamato anche come projectId.
TABLE_SCHEMA STRING Il nome del set di dati che contiene la vista materializzata. Inoltre indicato come datasetId.
TABLE_NAME STRING Il nome della vista materializzata. Chiamato anche tableId.
LAST_REFRESH_TIME TIMESTAMP La data e l'ora dell'ultimo aggiornamento di questa vista materializzata.
REFRESH_WATERMARK TIMESTAMP La filigrana di aggiornamento della vista materializzata. I dati contenuti in le tabelle di base con vista materializzata fino a questo momento sono incluse cache di vista materializzata.
LAST_REFRESH_STATUS RECORD Risultato dell'errore dell'ultimo job di aggiornamento automatico come ErrorProto . Se presente, indica che l'ultimo aggiornamento automatico non è riuscito.

Ambito e sintassi

Le query su questa vista devono includere un set di dati o un qualificatore di regione. Per con un qualificatore del set di dati, devi disporre delle autorizzazioni per il set di dati. Per le query con un qualificatore della regione, devi disporre delle autorizzazioni per il progetto. Per ulteriori informazioni consulta la sezione Sintassi. La tabella seguente illustra gli ambiti delle risorse e delle regioni per questa vista:

Nome vista Ambito risorsa Ambito della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.MATERIALIZED_VIEWS Livello di progetto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.MATERIALIZED_VIEWS Livello del set di dati Posizione del set di dati
Sostituisci quanto segue:

Ad esempio:

-- Returns metadata for views in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.MATERIALIZED_VIEWS;

-- Returns metadata for all views in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.MATERIALIZED_VIEWS;

Esempi

Esempio 1:

L'esempio seguente recupera tutte le viste materializzate in stato non integro dalla INFORMATION_SCHEMA.MATERIALIZED_VIEWS visualizzazione. Restituisce le viste materializzate con valori last_refresh_status non NULL in mydataset nel valore predefinito progetto - myproject.

Per eseguire la query su un progetto diverso da quello predefinito, aggiungi al set di dati nel seguente formato: `project_id`.dataset.INFORMATION_SCHEMA.MATERIALIZED_VIEWS; ad esempio `myproject`.mydataset.INFORMATION_SCHEMA.MATERIALIZED_VIEWS.

SELECT
  table_name, last_refresh_status
FROM
  mydataset.INFORMATION_SCHEMA.MATERIALIZED_VIEWS
WHERE
  last_refresh_status IS NOT NULL;

Il risultato è simile al seguente:

  +---------------+---------------------------------------------------------------------+
  |  table_name   |                        last_refresh_status                          |
  +---------------------------------------------------------------------+---------------+
  |  myview       |   {"reason":"invalidQuery","location":"query","message":"..."}      |
  +---------------------------------------------------------------------+---------------+

Esempio 2:

L'esempio seguente recupera gli attributi last_refresh_time e refresh_watermark di vista materializzata myview in mydataset nel tuo progetto predefinito: myproject. Il risultato mostra la data dell'ultimo aggiornamento della risorsa materializzata fino alla data quando i dati delle tabelle di base vengono raccolti nella cache delle vista materializzata.

Per eseguire la query su un progetto diverso da quello predefinito, aggiungi al set di dati nel seguente formato: `project_id`.dataset.INFORMATION_SCHEMA.MATERIALIZED_VIEWS; ad esempio `myproject`.mydataset.INFORMATION_SCHEMA.MATERIALIZED_VIEWS.

SELECT
  table_name, last_refresh_time, refresh_watermark
FROM
  mydataset.INFORMATION_SCHEMA.MATERIALIZED_VIEWS
WHERE
  table_name = 'myview';

Il risultato è simile al seguente:

  +---------------+------------------------------------------------+
  |  table_name   |  last_refresh_time     | refresh_watermark     |
  +---------------+------------------------------------------------+
  |  myview       | 2023-02-22 19:37:17    | 2023-03-08 16:52:57   |
  +---------------+------------------------------------------------+