Visualizzazione TABLE_SNAPSHOTS
La visualizzazione INFORMATION_SCHEMA.TABLE_SNAPSHOTS contiene metadati relativi a
snapshot delle tabelle. Per ulteriori informazioni, consulta Introduzione alla tabella
snapshot.
Autorizzazioni obbligatorie
Per eseguire query sulla vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS, è necessario il
bigquery.tables.list Autorizzazione Identity and Access Management (IAM) per il set di dati.
Il ruolo predefinito roles/bigquery.metadataViewer include i requisiti obbligatori
autorizzazione.
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 istantanea della tabella nel set di dati o nella regione specificati.
La tabella INFORMATION_SCHEMA.TABLE_SNAPSHOTS ha il seguente schema.
La tabella standard utilizzata
lo snapshot della tabella da cui è stato acquisito si chiama 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 che contiene 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 che contiene 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 |
Ambito e sintassi
Le query su questa vista devono includere un set di dati o un qualificatore 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 regione, devi disporre delle autorizzazioni per il progetto. Per maggiori informazioni per le informazioni, consulta 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.TABLE_SNAPSHOTS |
Livello progetto | REGION |
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
Livello del set di dati | Posizione del set di dati |
- Facoltativo:
PROJECT_ID: l'ID del tuo progetto Google Cloud. Se non viene 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 ulteriori informazioni, consulta 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 in mydataset
del set di dati. In questo esempio viene visualizzato l'istantanea tabella
myproject.mydataset.mytablesnapshot,
recuperato 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 | +----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+