Vista de TABLE_SNAPSHOTS
La vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS contiene metadatos sobre las instantáneas de la tabla. Para obtener más información, consulta Introducción a las instantáneas de tablas.
Permisos necesarios
Para consultar la vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS, necesitas el permiso bigquery.tables.list de administración de identidades y accesos (IAM) para el conjunto de datos.
La función predefinida roles/bigquery.metadataViewer incluye el permiso requerido.
Para obtener más información sobre IAM de BigQuery, consulta Control de acceso con IAM.
Schema
Cuando consultas la tabla INFORMATION_SCHEMA.TABLE_SNAPSHOTS, los resultados contienen una fila por cada instantánea de la tabla en la región o el conjunto de datos especificados.
La tabla INFORMATION_SCHEMA.TABLE_SNAPSHOTS tiene el siguiente esquema:
La tabla estándar de la que se tomó la instantánea de tabla se denomina tabla base.
| Nombre de la columna | Tipo de datos | Valor |
|---|---|---|
table_catalog |
STRING |
El nombre del proyecto que contiene la instantánea de la tabla |
table_schema |
STRING |
El nombre del conjunto de datos que contiene la instantánea de la tabla |
table_name |
STRING |
El nombre de la instantánea de la tabla |
base_table_catalog |
STRING |
El nombre del proyecto que contiene la tabla base |
base_table_schema |
STRING |
El nombre del conjunto de datos que contiene la tabla base |
base_table_name |
STRING |
El nombre de la tabla base |
snapshot_time |
TIMESTAMP |
La hora en la que se creó la instantánea de la tabla |
Permiso y sintaxis
Las consultas realizadas a esta vista deben incluir un conjunto de datos o un calificador de región. Para consultas con un calificador de conjunto de datos, debes tener permisos para el conjunto de datos. Para consultas con un calificador de región, debes tener permisos para el proyecto. Para obtener más información, consulta Sintaxis. En la siguiente tabla, se explican los permisos de la región y los recursos para esta vista:
| Nombre de la vista | Permiso del recurso | Permiso de la región |
|---|---|---|
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
Nivel de proyecto | REGION |
[`PROJECT_ID`.]DATASET_ID.INFORMATION_SCHEMA.TABLE_SNAPSHOTS |
Nivel de conjunto de datos | Ubicación del conjunto de datos |
- Opcional:
PROJECT_ID: el ID del proyecto de Google Cloud. Si no se especifica, se usa el proyecto predeterminado. REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo,region-us.DATASET_ID: Es el ID del conjunto de datos. Para obtener más información, consulta calificador de conjunto de datos.
Ejemplo
-- 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;
Ejemplo
La siguiente consulta recupera metadatos para las instantáneas de la tabla en el conjunto de datos mydataset. En este ejemplo, se muestra la instantánea myproject.mydataset.mytablesnapshot, que se tomó de la tabla base myproject.mydataset.mytable el 14 de mayo de 2021, a las 12 p.m. UTC.
SELECT * FROM `myproject`.mydataset.INFORMATION_SCHEMA.TABLE_SNAPSHOTS;
El resultado es similar al siguiente:
+----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+ | 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 | +----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+