Visualizzazione TABLE_SNAPSHOTS

La visualizzazione INFORMATION_SCHEMA.TABLE_SNAPSHOTS contiene i metadati relativi alle istantanee delle tabelle. Per saperne di più, consulta Introduzione agli snapshot delle tabelle.

Autorizzazioni obbligatorie

Per eseguire query sulla visualizzazione INFORMATION_SCHEMA.TABLE_SNAPSHOTS, devi disporre dell'autorizzazione Identity and Access Management (IAM) bigquery.tables.list per il set di dati. Il ruolo predefinito roles/bigquery.metadataViewer include l'autorizzazione richiesta.

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

Schema

Quando esegui una query sulla tabella INFORMATION_SCHEMA.TABLE_SNAPSHOTS, i risultati contengono una riga per ogni snapshot della tabella nel set di dati o nella regione specificati.

La tabella INFORMATION_SCHEMA.TABLE_SNAPSHOTS ha lo schema seguente. La tabella standard da cui è stato acquisito lo snapshot della tabella è denominata tabella di base.

Nome colonna Tipo di dati Valore
table_catalog STRING Il nome del progetto che contiene lo snapshot della tabella
table_schema STRING Il nome del set di dati contenente lo snapshot della tabella
table_name STRING Il nome dello snapshot della tabella
base_table_catalog STRING Il nome del progetto che contiene la tabella di base
base_table_schema STRING Il nome del set di dati contenente la tabella di base
base_table_name STRING Il nome della tabella di base
snapshot_time TIMESTAMP L'ora in cui è stato creato lo snapshot della tabella

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query dello schema informativo anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query se lo schema sottostante cambia.

Ambito e sintassi

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

Nome vista Ambito risorsa Ambito regione
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS Livello progetto REGION
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS Livello del set di dati Posizione del set di dati
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.
  • DATASET_ID: l'ID del set di dati. Per maggiori informazioni, vedi Qualificatore del set di dati.

Esempio

-- Returns metadata for the table snapshots in the specified dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

-- Returns metadata for the table snapshots in the specified region.
SELECT * FROM `region-us`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

Esempio

La seguente query recupera i metadati per gli snapshot della tabella nel set di dati mydataset. In questo esempio, viene visualizzato lo snapshot della tabella myproject.mydataset.mytablesnapshot, che è stato creato dalla tabella di base myproject.mydataset.mytable il 14 maggio 2021 alle 12:00 UTC.

SELECT *
FROM
  `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;

Il risultato è simile al seguente:

+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+
| table_catalog  | table_schema  | table_name      | base_table_catalog | base_table_schema | base_table_name | snapshot_time               |
+----------------+---------------+-----------------+----------------------------------------------------------------------------------------+
| myproject      | mydataset     | mytablesnapshot | myProject          | mydataset         | mytable         | 2021-05-14 12:00:00.000 UTC |
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+