Vista TABLE_SNAPSHOTS
La vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS contiene metadatos sobre las instantáneas de tus tablas. Para obtener más información, consulta Introducción a las copias de una tabla.
Permisos obligatorios
Para consultar la vista INFORMATION_SCHEMA.TABLE_SNAPSHOTS, necesitas el permiso de gestión de identidades y accesos (IAM) bigquery.tables.list para el conjunto de datos.
El rol predefinido roles/bigquery.metadataViewer incluye el permiso necesario.
Para obtener más información sobre los permisos de BigQuery, consulta Control de acceso con gestión de identidades y accesos.
Esquema
Cuando consultas la tabla INFORMATION_SCHEMA.TABLE_SNAPSHOTS, los resultados contienen una fila por cada instantánea de tabla del conjunto de datos o de la región especificados.
La tabla INFORMATION_SCHEMA.TABLE_SNAPSHOTS tiene el siguiente esquema.
La tabla estándar de la que se ha tomado la instantánea 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 |
Nombre del conjunto de datos que contiene la captura de la tabla |
table_name |
STRING |
Nombre de la captura de tabla |
base_table_catalog |
STRING |
El nombre del proyecto que contiene la tabla base |
base_table_schema |
STRING |
Nombre del conjunto de datos que contiene la tabla base. |
base_table_name |
STRING |
Nombre de la tabla base |
snapshot_time |
TIMESTAMP |
Hora en la que se creó la captura de la tabla. |
Ámbito y sintaxis
Las consultas en esta vista deben incluir un conjunto de datos o un calificador de región. En el caso de las consultas con un calificador de conjunto de datos, debes tener permisos para el conjunto de datos. En el caso de las consultas con un calificador de región, debes tener permisos para el proyecto. Para obtener más información, consulta la sección Sintaxis. En la siguiente tabla se explican los ámbitos de región y de recurso de esta vista:
| Nombre de la vista | Ámbito de los recursos | Ámbito 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 del conjunto de datos | Ubicación del conjunto de datos |
-
Opcional:
PROJECT_ID: el ID de tu Google Cloud proyecto. 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: el ID de tu 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 obtiene los metadatos de las capturas de la tabla del conjunto de datos mydataset. En este ejemplo, se muestra la instantánea de la tabla myproject.mydataset.mytablesnapshot,
que se tomó de la tabla base myproject.mydataset.mytable el 14 de mayo del 2021 a las 12:00 (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 | +----------------+---------------+-----------------+--------------------+-------------------+-----------------+-----------------------------+