Visualizzazione TABLE_SNAPSHOTS
La vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS
contiene i metadati relativi agli snapshot della tabella. Per ulteriori informazioni, consulta Introduzione agli snapshot
delle tabelle.
Autorizzazioni obbligatorie
Per eseguire una query sulla vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS
, devi disporre
dell'autorizzazione bigquery.tables.list
Identity and Access Management (IAM) per il set di dati.
Il ruolo predefinito roles/bigquery.metadataViewer
include l'autorizzazione
richiesta.
Per maggiori 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 il seguente schema.
La tabella standard da cui è stato estratto 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 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 di creazione dello snapshot della tabella. |
Ambito e sintassi
Le query in questa visualizzazione 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 di regione, devi disporre delle autorizzazioni per il progetto. Per ulteriori informazioni, consulta la sezione Sintassi. La tabella seguente illustra gli ambiti a livello di regione e risorsa per questa visualizzazione:
Nome vista | Ambito risorsa | Ambito regione |
---|---|---|
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
A livello di progetto | REGION |
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
Livello set di dati | Posizione del set di dati |
- (Facoltativo)
PROJECT_ID
: l'ID del tuo progetto Google Cloud. 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 ulteriori informazioni, consulta la sezione 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, mostra lo snapshot della tabella myproject.mydataset.mytablesnapshot
, recuperato dalla tabella di base myproject.mydataset.mytable
il 14 maggio 2021, alle ore 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 | +----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+